# Job (/ats/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 {
  candidates(
    after: String
    before: String
    filter: JobCandidateFilter
    first: Int
    last: Int
  ): JobCandidateConnection!
  companyName: String
  companyWebsite: String
  createdAt: DateTime!
  description: String
  id: ID!
  location: String
  mustHaves: [String!]!
  niceToHaves: [String!]!
  redFlags: [String!]!
  salaryMax: Int
  salaryMin: Int
  searchStatus: JobSearchStatus
  status: JobStatus!
  title: String!
  updatedAt: DateTime!
}
```

### Fields [#fields]

#### [`Job.candidates`](#candidates) · [`JobCandidateConnection!`](/ats/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`](/ats/reference/scalars/string) `scalar` [#job-candidates-after]
Return the rows that follow this cursor.

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

##### [`Job.candidates.filter`](#job-candidates-filter) · [`JobCandidateFilter`](/ats/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`](/ats/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`](/ats/reference/scalars/int) `scalar` [#job-candidates-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

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

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

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

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

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

#### [`Job.location`](#location) · [`String`](/ats/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!]!`](/ats/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!]!`](/ats/reference/scalars/string) `non-null` `scalar` [#nice-to-haves]
What counts in a candidate's favour without being required.

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

#### [`Job.salaryMax`](#salary-max) · [`Int`](/ats/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`](/ats/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`](/ats/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!`](/ats/reference/enums/job-status) `non-null` `enum` [#status]
Whether the job is being worked.

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

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

### Returned By [#returned-by]

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

### Member Of [#member-of]

[`JobCandidate`](/ats/reference/objects/job-candidate)  `object` · [`JobEdge`](/ats/reference/objects/job-edge)  `object`