# Company (/api/reference/objects/company)

A company the workspace knows: a client, a lead it is trying to win, or simply where a candidate works. `relationship` says which. A workspace holds one company per name (see `addCompany` for how names are matched).

```graphql
type Company {
  contactCount: Int!
  contacts(
    after: String
    before: String
    first: Int
    last: Int
  ): ClientContactConnection!
  createdAt: DateTime!
  defaultFeeBasis: FeeBasis
  defaultFeePercent: Decimal
  defaultGuaranteeDays: Int
  fieldValues(
    after: String
    before: String
    first: Int
    last: Int
  ): FieldValueConnection!
  id: ID!
  isArchived: Boolean!
  jobs(
    after: String
    before: String
    filter: JobFilter
    first: Int
    last: Int
  ): JobConnection!
  lastActivityAt: DateTime
  linkedinUrl: String
  location: String
  logoUrl: String
  name: String!
  notes: String
  openJobCount: Int!
  opportunities(
    after: String
    before: String
    first: Int
    last: Int
  ): OpportunityConnection!
  owner: User
  people(
    after: String
    before: String
    first: Int
    last: Int
  ): PersonConnection!
  pitchPageCount: Int!
  pursuits(
    after: String
    before: String
    first: Int
    last: Int
  ): PursuitConnection!
  relationship: CompanyRelationship
  restrictions(
    after: String
    before: String
    first: Int
    last: Int
  ): RestrictionConnection!
  sector: String
  sectorTags: [String!]!
  status: CompanyStatus
  touches(
    after: String
    before: String
    first: Int
    last: Int
  ): TouchConnection!
  updatedAt: DateTime!
  website: String
  websiteResearch: CompanyWebsiteResearch
}
```

### Fields [#fields]

#### [`Company.contactCount`](#contact-count) · [`Int!`](/api/reference/scalars/int) `non-null` `scalar` [#contact-count]
How many contacts the company has.

#### [`Company.contacts`](#contacts) · [`ClientContactConnection!`](/api/reference/objects/client-contact-connection) `non-null` `object` [#contacts]
The people the workspace deals with at this company, by name, in the order they were added.
##### [`Company.contacts.after`](#company-contacts-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-contacts-after]
Return the rows that follow this cursor.

##### [`Company.contacts.before`](#company-contacts-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-contacts-before]
Return the rows that come before this cursor.

##### [`Company.contacts.first`](#company-contacts-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-contacts-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.contacts.last`](#company-contacts-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-contacts-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.createdAt`](#created-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When the company was added to the workspace.

#### [`Company.defaultFeeBasis`](#default-fee-basis) · [`FeeBasis`](/api/reference/enums/fee-basis) `enum` [#default-fee-basis]
What `defaultFeePercent` is a percentage of.

#### [`Company.defaultFeePercent`](#default-fee-percent) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#default-fee-percent]
The fee, as a percentage from 0 to 100, that a new opportunity with this company starts with.

#### [`Company.defaultGuaranteeDays`](#default-guarantee-days) · [`Int`](/api/reference/scalars/int) `scalar` [#default-guarantee-days]
How many days of guarantee a new opportunity with this company starts with.

#### [`Company.fieldValues`](#field-values) · [`FieldValueConnection!`](/api/reference/objects/field-value-connection) `non-null` `object` [#field-values]
The workspace's own fields that have a value on this company, in the order they were first set.
##### [`Company.fieldValues.after`](#company-field-values-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-field-values-after]
Return the rows that follow this cursor.

##### [`Company.fieldValues.before`](#company-field-values-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-field-values-before]
Return the rows that come before this cursor.

##### [`Company.fieldValues.first`](#company-field-values-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-field-values-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.fieldValues.last`](#company-field-values-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-field-values-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The company's id, as in its URL in the app (`/clients/7`).

#### [`Company.isArchived`](#is-archived) · [`Boolean!`](/api/reference/scalars/boolean) `non-null` `scalar` [#is-archived]
True when the relationship has been put away. The company is left out of everyday client lists; its contacts, jobs and pitch pages are kept.

#### [`Company.jobs`](#jobs) · [`JobConnection!`](/api/reference/objects/job-connection) `non-null` `object` [#jobs]
The jobs the workspace works for this company: those naming it as the client, and those naming one of its contacts. Jobs still in `DRAFT` are left out unless `filter.statuses` asks for them. Newest first.
##### [`Company.jobs.after`](#company-jobs-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-jobs-after]
Return the rows that follow this cursor.

##### [`Company.jobs.before`](#company-jobs-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-jobs-before]
Return the rows that come before this cursor.

##### [`Company.jobs.filter`](#company-jobs-filter) · [`JobFilter`](/api/reference/inputs/job-filter) `input` [#company-jobs-filter]
Narrow the list by status. Left out, every job that is not a draft is returned.

##### [`Company.jobs.first`](#company-jobs-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-jobs-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.jobs.last`](#company-jobs-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-jobs-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.lastActivityAt`](#last-activity-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#last-activity-at]
When anything last happened with this company: a contact was edited, one of its jobs or a candidate on one changed, a pitch page was made, sent or opened, or a pursuit changed. Not when the company's own record changed, which enrichment also does. Null when nothing has.

#### [`Company.linkedinUrl`](#linkedin-url) · [`String`](/api/reference/scalars/string) `scalar` [#linkedin-url]
The company's LinkedIn page.

#### [`Company.location`](#location) · [`String`](/api/reference/scalars/string) `scalar` [#location]
Where the company is based, as written.

#### [`Company.logoUrl`](#logo-url) · [`String`](/api/reference/scalars/string) `scalar` [#logo-url]
A logo recorded for the company. When null, apps derive a logo from `website`.

#### [`Company.name`](#name) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#name]
The company's name.

#### [`Company.notes`](#notes) · [`String`](/api/reference/scalars/string) `scalar` [#notes]
Notes about the relationship.

#### [`Company.openJobCount`](#open-job-count) · [`Int!`](/api/reference/scalars/int) `non-null` `scalar` [#open-job-count]
How many of the company's jobs are `OPEN`. Counts the jobs `jobs` lists: those naming the company, and those naming one of its contacts.

#### [`Company.opportunities`](#opportunities) · [`OpportunityConnection!`](/api/reference/objects/opportunity-connection) `non-null` `object` [#opportunities]
The opportunities with this company, oldest first.
##### [`Company.opportunities.after`](#company-opportunities-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-opportunities-after]
Return the rows that follow this cursor.

##### [`Company.opportunities.before`](#company-opportunities-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-opportunities-before]
Return the rows that come before this cursor.

##### [`Company.opportunities.first`](#company-opportunities-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-opportunities-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.opportunities.last`](#company-opportunities-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-opportunities-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.owner`](#owner) · [`User`](/api/reference/objects/user) `object` [#owner]
The member who looks after the relationship. Null when nobody does, or they have left the workspace.

#### [`Company.people`](#people) · [`PersonConnection!`](/api/reference/objects/person-connection) `non-null` `object` [#people]
The people recorded as working here, in the order they were recorded.
##### [`Company.people.after`](#company-people-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-people-after]
Return the rows that follow this cursor.

##### [`Company.people.before`](#company-people-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-people-before]
Return the rows that come before this cursor.

##### [`Company.people.first`](#company-people-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-people-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.people.last`](#company-people-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-people-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.pitchPageCount`](#pitch-page-count) · [`Int!`](/api/reference/scalars/int) `non-null` `scalar` [#pitch-page-count]
How many pitch pages have been made to win work from this company, whatever state each is in.

#### [`Company.pursuits`](#pursuits) · [`PursuitConnection!`](/api/reference/objects/pursuit-connection) `non-null` `object` [#pursuits]
The attempts to win this company through a named person there, newest first. See `Pursuit`.
##### [`Company.pursuits.after`](#company-pursuits-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-pursuits-after]
Return the rows that follow this cursor.

##### [`Company.pursuits.before`](#company-pursuits-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-pursuits-before]
Return the rows that come before this cursor.

##### [`Company.pursuits.first`](#company-pursuits-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-pursuits-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.pursuits.last`](#company-pursuits-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-pursuits-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.relationship`](#relationship) · [`CompanyRelationship`](/api/reference/enums/company-relationship) `enum` [#relationship]
What the company is to the workspace: a client, a lead, or null for a company that is only a candidate's employer.

#### [`Company.restrictions`](#restrictions) · [`RestrictionConnection!`](/api/reference/objects/restriction-connection) `non-null` `object` [#restrictions]
The do-not-contact rules on this company, oldest first. Read `isInForce` on each before sourcing from it or writing to its staff.
##### [`Company.restrictions.after`](#company-restrictions-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-restrictions-after]
Return the rows that follow this cursor.

##### [`Company.restrictions.before`](#company-restrictions-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-restrictions-before]
Return the rows that come before this cursor.

##### [`Company.restrictions.first`](#company-restrictions-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-restrictions-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.restrictions.last`](#company-restrictions-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-restrictions-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.sector`](#sector) · [`String`](/api/reference/scalars/string) `scalar` [#sector]
What the company does, in a few words, as a recruiter wrote it.

#### [`Company.sectorTags`](#sector-tags) · [`[String!]!`](/api/reference/scalars/string) `non-null` `scalar` [#sector-tags]
The workspace's own sector labels for the company. Empty when it has none.

#### [`Company.status`](#status) · [`CompanyStatus`](/api/reference/enums/company-status) `enum` [#status]
Where the commercial relationship stands, in more detail than `relationship`. The two keep step: `CLIENT` and `FORMER_CLIENT` are clients, the rest are leads. Null when `relationship` is null.

#### [`Company.touches`](#touches) · [`TouchConnection!`](/api/reference/objects/touch-connection) `non-null` `object` [#touches]
Every message, call and meeting filed under this company, newest recorded first.
##### [`Company.touches.after`](#company-touches-after) · [`String`](/api/reference/scalars/string) `scalar` [#company-touches-after]
Return the rows that follow this cursor.

##### [`Company.touches.before`](#company-touches-before) · [`String`](/api/reference/scalars/string) `scalar` [#company-touches-before]
Return the rows that come before this cursor.

##### [`Company.touches.first`](#company-touches-first) · [`Int`](/api/reference/scalars/int) `scalar` [#company-touches-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Company.touches.last`](#company-touches-last) · [`Int`](/api/reference/scalars/int) `scalar` [#company-touches-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Company.updatedAt`](#updated-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When the company's own record last changed, by anyone or anything. For the last dealing with the company, read `lastActivityAt`.

#### [`Company.website`](#website) · [`String`](/api/reference/scalars/string) `scalar` [#website]
The company's own website. Null when none is known.

#### [`Company.websiteResearch`](#website-research) · [`CompanyWebsiteResearch`](/api/reference/objects/company-website-research) `object` [#website-research]
Where the automatic search for the company's website stands. Null when none was ever asked for.

### Returned By [#returned-by]

[`company`](/api/reference/queries/company)  `query`

### Member Of [#member-of]

[`AddCompanyPayload`](/api/reference/objects/add-company-payload)  `object` · [`ArchiveCompanyPayload`](/api/reference/objects/archive-company-payload)  `object` · [`Candidate`](/api/reference/objects/candidate)  `object` · [`CandidateEmployment`](/api/reference/objects/candidate-employment)  `object` · [`ChangeSuggestion`](/api/reference/objects/change-suggestion)  `object` · [`ChangeSuggestionChange`](/api/reference/objects/change-suggestion-change)  `object` · [`ClientContact`](/api/reference/objects/client-contact)  `object` · [`CompanyEdge`](/api/reference/objects/company-edge)  `object` · [`FieldValue`](/api/reference/objects/field-value)  `object` · [`Job`](/api/reference/objects/job)  `object` · [`Opportunity`](/api/reference/objects/opportunity)  `object` · [`Person`](/api/reference/objects/person)  `object` · [`Pursuit`](/api/reference/objects/pursuit)  `object` · [`RestoreCompanyPayload`](/api/reference/objects/restore-company-payload)  `object` · [`Restriction`](/api/reference/objects/restriction)  `object` · [`Touch`](/api/reference/objects/touch)  `object` · [`UpdateCompanyPayload`](/api/reference/objects/update-company-payload)  `object`