New: Kith open-sources its ATS.Read why
Skip to Content
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).

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

Company.contactCount · Int! non-null scalar

How many contacts the company has.

Company.contacts · ClientContactConnection! non-null object

The people the workspace deals with at this company, by name, in the order they were added.

Company.contacts.after · String scalar

Return the rows that follow this cursor.

Company.contacts.before · String scalar

Return the rows that come before this cursor.

Company.contacts.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.contacts.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.createdAt · DateTime! non-null scalar

When the company was added to the workspace.

Company.defaultFeeBasis · FeeBasis enum

What defaultFeePercent is a percentage of.

Company.defaultFeePercent · Decimal scalar

The fee, as a percentage from 0 to 100, that a new opportunity with this company starts with.

Company.defaultGuaranteeDays · Int scalar

How many days of guarantee a new opportunity with this company starts with.

Company.fieldValues · FieldValueConnection! non-null object

The workspace's own fields that have a value on this company, in the order they were first set.

Company.fieldValues.after · String scalar

Return the rows that follow this cursor.

Company.fieldValues.before · String scalar

Return the rows that come before this cursor.

Company.fieldValues.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.fieldValues.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.id · ID! non-null scalar

The company's id, as in its URL in the app (/clients/7).

Company.isArchived · Boolean! non-null scalar

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 · JobConnection! non-null object

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 · String scalar

Return the rows that follow this cursor.

Company.jobs.before · String scalar

Return the rows that come before this cursor.

Company.jobs.filter · JobFilter input

Narrow the list by status. Left out, every job that is not a draft is returned.

Company.jobs.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.jobs.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.lastActivityAt · DateTime scalar

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 · String scalar

The company's LinkedIn page.

Company.location · String scalar

Where the company is based, as written.

Company.logoUrl · String scalar

A logo recorded for the company. When null, apps derive a logo from website.

Company.name · String! non-null scalar

The company's name.

Company.notes · String scalar

Notes about the relationship.

Company.openJobCount · Int! non-null scalar

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 · OpportunityConnection! non-null object

The opportunities with this company, oldest first.

Company.opportunities.after · String scalar

Return the rows that follow this cursor.

Company.opportunities.before · String scalar

Return the rows that come before this cursor.

Company.opportunities.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.opportunities.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.owner · User object

The member who looks after the relationship. Null when nobody does, or they have left the workspace.

Company.people · PersonConnection! non-null object

The people recorded as working here, in the order they were recorded.

Company.people.after · String scalar

Return the rows that follow this cursor.

Company.people.before · String scalar

Return the rows that come before this cursor.

Company.people.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.people.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.pitchPageCount · Int! non-null scalar

How many pitch pages have been made to win work from this company, whatever state each is in.

Company.pursuits · PursuitConnection! non-null object

The attempts to win this company through a named person there, newest first. See Pursuit.

Company.pursuits.after · String scalar

Return the rows that follow this cursor.

Company.pursuits.before · String scalar

Return the rows that come before this cursor.

Company.pursuits.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.pursuits.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.relationship · CompanyRelationship enum

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 · RestrictionConnection! non-null object

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 · String scalar

Return the rows that follow this cursor.

Company.restrictions.before · String scalar

Return the rows that come before this cursor.

Company.restrictions.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.restrictions.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.sector · String scalar

What the company does, in a few words, as a recruiter wrote it.

Company.sectorTags · [String!]! non-null scalar

The workspace's own sector labels for the company. Empty when it has none.

Company.status · CompanyStatus enum

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 · TouchConnection! non-null object

Every message, call and meeting filed under this company, newest recorded first.

Company.touches.after · String scalar

Return the rows that follow this cursor.

Company.touches.before · String scalar

Return the rows that come before this cursor.

Company.touches.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Company.touches.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Company.updatedAt · DateTime! non-null scalar

When the company's own record last changed, by anyone or anything. For the last dealing with the company, read lastActivityAt.

Company.website · String scalar

The company's own website. Null when none is known.

Company.websiteResearch · CompanyWebsiteResearch object

Where the automatic search for the company's website stands. Null when none was ever asked for.

Returned By

company query

Member Of

AddCompanyPayload object · ArchiveCompanyPayload object · Candidate object · CandidateEmployment object · ChangeSuggestion object · ChangeSuggestionChange object · ClientContact object · CompanyEdge object · FieldValue object · Job object · Opportunity object · Person object · Pursuit object · RestoreCompanyPayload object · Restriction object · Touch object · UpdateCompanyPayload object

On this page

FieldsCompany.contactCount · Int! non-null scalarCompany.contacts · ClientContactConnection! non-null objectCompany.contacts.after · String scalarCompany.contacts.before · String scalarCompany.contacts.first · Int scalarCompany.contacts.last · Int scalarCompany.createdAt · DateTime! non-null scalarCompany.defaultFeeBasis · FeeBasis enumCompany.defaultFeePercent · Decimal scalarCompany.defaultGuaranteeDays · Int scalarCompany.fieldValues · FieldValueConnection! non-null objectCompany.fieldValues.after · String scalarCompany.fieldValues.before · String scalarCompany.fieldValues.first · Int scalarCompany.fieldValues.last · Int scalarCompany.id · ID! non-null scalarCompany.isArchived · Boolean! non-null scalarCompany.jobs · JobConnection! non-null objectCompany.jobs.after · String scalarCompany.jobs.before · String scalarCompany.jobs.filter · JobFilter inputCompany.jobs.first · Int scalarCompany.jobs.last · Int scalarCompany.lastActivityAt · DateTime scalarCompany.linkedinUrl · String scalarCompany.location · String scalarCompany.logoUrl · String scalarCompany.name · String! non-null scalarCompany.notes · String scalarCompany.openJobCount · Int! non-null scalarCompany.opportunities · OpportunityConnection! non-null objectCompany.opportunities.after · String scalarCompany.opportunities.before · String scalarCompany.opportunities.first · Int scalarCompany.opportunities.last · Int scalarCompany.owner · User objectCompany.people · PersonConnection! non-null objectCompany.people.after · String scalarCompany.people.before · String scalarCompany.people.first · Int scalarCompany.people.last · Int scalarCompany.pitchPageCount · Int! non-null scalarCompany.pursuits · PursuitConnection! non-null objectCompany.pursuits.after · String scalarCompany.pursuits.before · String scalarCompany.pursuits.first · Int scalarCompany.pursuits.last · Int scalarCompany.relationship · CompanyRelationship enumCompany.restrictions · RestrictionConnection! non-null objectCompany.restrictions.after · String scalarCompany.restrictions.before · String scalarCompany.restrictions.first · Int scalarCompany.restrictions.last · Int scalarCompany.sector · String scalarCompany.sectorTags · [String!]! non-null scalarCompany.status · CompanyStatus enumCompany.touches · TouchConnection! non-null objectCompany.touches.after · String scalarCompany.touches.before · String scalarCompany.touches.first · Int scalarCompany.touches.last · Int scalarCompany.updatedAt · DateTime! non-null scalarCompany.website · String scalarCompany.websiteResearch · CompanyWebsiteResearch objectReturned ByMember Of