# Job (/api/reference/objects/job)

A role a workspace is hiring for, with its brief. Candidates are worked against a job one by one: see `candidates`.

```graphql
type Job {
  auditTrail(
    after: String
    filter: AuditFilter
    first: Int
  ): AuditEntryConnection!
  briefRevision: Int!
  candidates(
    after: String
    before: String
    filter: JobCandidateFilter
    first: Int
    last: Int
  ): JobCandidateConnection!
  client: Company
  companyName: String
  companyWebsite: String
  createdAt: DateTime!
  description: String
  documents(
    after: String
    before: String
    first: Int
    last: Int
  ): JobDocumentConnection!
  expectedFee: Decimal
  id: ID!
  location: String
  mustHaves: [String!]!
  niceToHaves: [String!]!
  opportunity: Opportunity
  pipelineSummary: JobPipelineSummary
  recruitingTasks(
    after: String
    before: String
    filter: RecruitingTaskFilter
    first: Int
    last: Int
  ): RecruitingTaskConnection!
  redFlags: [String!]!
  salaryMax: Int
  salaryMin: Int
  searchStatus: JobSearchStatus
  status: JobStatus!
  title: String!
  updatedAt: DateTime!
}
```

### Fields [#fields]

#### [`Job.auditTrail`](#audit-trail) · [`AuditEntryConnection!`](/api/reference/objects/audit-entry-connection) `non-null` `object` [#audit-trail]
Everything that has happened to people on this job: stage moves and decisions, notes and agents' runs, newest first. The filter is applied to the whole trail before it is paged. Entries about people, or places on the job, not yet released to the workspace are left out. This list pages forward only.
##### [`Job.auditTrail.after`](#job-audit-trail-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-audit-trail-after]
Return the entries that follow this cursor.

##### [`Job.auditTrail.filter`](#job-audit-trail-filter) · [`AuditFilter`](/api/reference/inputs/audit-filter) `input` [#job-audit-trail-filter]
Narrow the list. Left out, every entry is listed.

##### [`Job.auditTrail.first`](#job-audit-trail-first) · [`Int`](/api/reference/scalars/int) `scalar` [#job-audit-trail-first]
How many entries to return. 50 when left out, 200 at most.

#### [`Job.briefRevision`](#brief-revision) · [`Int!`](/api/reference/scalars/int) `non-null` `scalar` [#brief-revision]
The number of the brief's current revision. It starts at 1 and grows by one with every change to the brief, whoever made it. Send it as `baseRevision` when you edit the brief, and compare it with an earlier read to know whether the brief has changed. 0 for a job whose brief has no recorded history yet.

#### [`Job.candidates`](#candidates) · [`JobCandidateConnection!`](/api/reference/objects/job-candidate-connection) `non-null` `object` [#candidates]
The candidates on this job, each with their stage, grade and decision, in the order they were added. Candidates still in Kith ATS's own sourcing review are not included.
##### [`Job.candidates.after`](#job-candidates-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-candidates-after]
Return the rows that follow this cursor.

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

##### [`Job.candidates.filter`](#job-candidates-filter) · [`JobCandidateFilter`](/api/reference/inputs/job-candidate-filter) `input` [#job-candidates-filter]
Narrow the list. Left out, every candidate on the job is returned.

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

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

#### [`Job.client`](#client) · [`Company`](/api/reference/objects/company) `object` [#client]
The client company this job is for, once the job is linked to a company in the workspace's records. Null until then: `companyName` is only what the brief calls the company.

#### [`Job.companyName`](#company-name) · [`String`](/api/reference/scalars/string) `scalar` [#company-name]
The hiring company, as the brief names it.

#### [`Job.companyWebsite`](#company-website) · [`String`](/api/reference/scalars/string) `scalar` [#company-website]
The hiring company's website, as `https://` and its public domain.

#### [`Job.createdAt`](#created-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When the job was created.

#### [`Job.description`](#description) · [`String`](/api/reference/scalars/string) `scalar` [#description]
The role, described in prose. May be long.

#### [`Job.documents`](#documents) · [`JobDocumentConnection!`](/api/reference/objects/job-document-connection) `non-null` `object` [#documents]
The documents uploaded to the job, in the order they were uploaded. Ask for `last` to read the newest.
##### [`Job.documents.after`](#job-documents-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-documents-after]
Return the rows that follow this cursor.

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

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

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

#### [`Job.expectedFee`](#expected-fee) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#expected-fee]
The fee the job is expected to bring, in its opportunity's currency. Under an opportunity whose fee is a percentage of first-year base, the server works it out from the middle of the salary range; otherwise it is the figure last entered.

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

#### [`Job.location`](#location) · [`String`](/api/reference/scalars/string) `scalar` [#location]
Where the role is based, as the brief says it: a city, a region, "Remote".

#### [`Job.mustHaves`](#must-haves) · [`[String!]!`](/api/reference/scalars/string) `non-null` `scalar` [#must-haves]
What a candidate must have to be considered, one requirement per entry.

#### [`Job.niceToHaves`](#nice-to-haves) · [`[String!]!`](/api/reference/scalars/string) `non-null` `scalar` [#nice-to-haves]
What counts in a candidate's favour without being required.

#### [`Job.opportunity`](#opportunity) · [`Opportunity`](/api/reference/objects/opportunity) `object` [#opportunity]
The opportunity the job is worked under: the agreement whose terms set its fee. Null for a job with none, which is usual before terms are agreed.

#### [`Job.pipelineSummary`](#pipeline-summary) · [`JobPipelineSummary`](/api/reference/objects/job-pipeline-summary) `object` [#pipeline-summary]
How many candidates are on the job at each stage, and when its pipeline last changed. Counts only candidates released to the workspace. Cheaper than reading `candidates` for the counts alone.

#### [`Job.recruitingTasks`](#recruiting-tasks) · [`RecruitingTaskConnection!`](/api/reference/objects/recruiting-task-connection) `non-null` `object` [#recruiting-tasks]
Tasks the recruiting team created on this job, in id order, including completed and dismissed work.
##### [`Job.recruitingTasks.after`](#job-recruiting-tasks-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-recruiting-tasks-after]
Return the rows that follow this cursor.

##### [`Job.recruitingTasks.before`](#job-recruiting-tasks-before) · [`String`](/api/reference/scalars/string) `scalar` [#job-recruiting-tasks-before]
Return the rows that come before this cursor.

##### [`Job.recruitingTasks.filter`](#job-recruiting-tasks-filter) · [`RecruitingTaskFilter`](/api/reference/inputs/recruiting-task-filter) `input` [#job-recruiting-tasks-filter]
Narrow the tasks on this job.

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

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

#### [`Job.redFlags`](#red-flags) · [`[String!]!`](/api/reference/scalars/string) `non-null` `scalar` [#red-flags]
What rules a candidate out, or counts against them.

#### [`Job.salaryMax`](#salary-max) · [`Int`](/api/reference/scalars/int) `scalar` [#salary-max]
The top of the base salary range, in whole units of the role's currency.

#### [`Job.salaryMin`](#salary-min) · [`Int`](/api/reference/scalars/int) `scalar` [#salary-min]
The bottom of the base salary range, in whole units of the role's currency.

#### [`Job.searchStatus`](#search-status) · [`JobSearchStatus`](/api/reference/enums/job-search-status) `enum` [#search-status]
How far the search has got, when the team tracks it. Null when it does not.

#### [`Job.status`](#status) · [`JobStatus!`](/api/reference/enums/job-status) `non-null` `enum` [#status]
Whether the job is being worked.

#### [`Job.title`](#title) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#title]
The role's title, such as "Founding Account Executive".

#### [`Job.updatedAt`](#updated-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When the job itself last changed.

### Returned By [#returned-by]

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

### Member Of [#member-of]

[`AuditEntry`](/api/reference/objects/audit-entry)  `object` · [`CallAction`](/api/reference/objects/call-action)  `object` · [`CallRoleMatch`](/api/reference/objects/call-role-match)  `object` · [`CandidateNote`](/api/reference/objects/candidate-note)  `object` · [`CreateExampleJobPayload`](/api/reference/objects/create-example-job-payload)  `object` · [`CreateJobPayload`](/api/reference/objects/create-job-payload)  `object` · [`JobCandidate`](/api/reference/objects/job-candidate)  `object` · [`JobEdge`](/api/reference/objects/job-edge)  `object` · [`Presentation`](/api/reference/objects/presentation)  `object` · [`RecruitingTask`](/api/reference/objects/recruiting-task)  `object` · [`RoleRecommendation`](/api/reference/objects/role-recommendation)  `object` · [`SetJobOpportunityPayload`](/api/reference/objects/set-job-opportunity-payload)  `object` · [`SetJobStatusPayload`](/api/reference/objects/set-job-status-payload)  `object` · [`Touch`](/api/reference/objects/touch)  `object`

## Shown in the UI [#shown-in-the-ui]

These components show it:

- [Job summary card](/ui/job-summary-card): A job at a glance.
- [Job brief](/ui/job-brief-card): A versioned brief with must-haves, nice-to-haves and red flags.