# JobCandidate (/api/reference/objects/job-candidate)

A candidate's place on one job: their stage in its pipeline, how well they fit, and the recruiter's decision. A candidate has one of these for each job they are on.

```graphql
type JobCandidate {
  adjustedScore: Int
  assessedGrade: JobCandidateGrade
  candidate: Candidate!
  confidence: JobCandidateConfidence
  contactChannels: [JobCandidateContact!]!
  createdAt: DateTime!
  currency: String!
  decidedAt: DateTime
  decidedBy: User
  decision: JobCandidateDecision
  decisionReason: String
  grade: JobCandidateGrade
  id: ID!
  interviews(
    after: String
    before: String
    first: Int
    last: Int
  ): InterviewConnection!
  isGradeOverridden: Boolean!
  job: Job!
  latestNote: CandidateNote
  nextAction: String
  nextActionDueAt: DateTime
  notes: String
  offerAcceptedAt: Date
  offerSalary: Decimal
  outreachDrafts(
    after: String
    before: String
    first: Int
    last: Int
  ): OutreachDraftConnection!
  owner: User
  placementFee: Decimal
  placementVersion: String!
  recruitingTasks(
    after: String
    before: String
    filter: RecruitingTaskFilter
    first: Int
    last: Int
  ): RecruitingTaskConnection!
  score: Int
  signals: [JobCandidateSignal!]!
  stage: JobCandidateStage!
  startDate: Date
  submittedAt: DateTime
  summary: [JobCandidateSummaryPoint!]
  timelineNotes(
    after: String
    before: String
    first: Int
    last: Int
  ): CandidateNoteConnection!
  updatedAt: DateTime!
  version: String!
}
```

### Fields [#fields]

#### [`JobCandidate.adjustedScore`](#adjusted-score) · [`Int`](/api/reference/scalars/int) `scalar` [#adjusted-score]
The score from 0 to 100 after it was re-ranked against the recruiter's own criteria, when they have recorded any.

#### [`JobCandidate.assessedGrade`](#assessed-grade) · [`JobCandidateGrade`](/api/reference/enums/job-candidate-grade) `enum` [#assessed-grade]
The grade the automatic assessment last gave, kept even when a recruiter has set `grade` themselves.

#### [`JobCandidate.candidate`](#candidate) · [`Candidate!`](/api/reference/objects/candidate) `non-null` `object` [#candidate]
The candidate.

#### [`JobCandidate.confidence`](#confidence) · [`JobCandidateConfidence`](/api/reference/enums/job-candidate-confidence) `enum` [#confidence]
How sure the automatic assessment is of its grade.

#### [`JobCandidate.contactChannels`](#contact-channels) · [`[JobCandidateContact!]!`](/api/reference/objects/job-candidate-contact) `non-null` `object` [#contact-channels]
Which channels the candidate has been contacted on for this job, each with its latest touch.

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

#### [`JobCandidate.currency`](#currency) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#currency]
The currency of `offerSalary` and `placementFee`, as a three-letter ISO 4217 code such as `GBP`.

#### [`JobCandidate.decidedAt`](#decided-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#decided-at]
When the standing decision was made.

#### [`JobCandidate.decidedBy`](#decided-by) · [`User`](/api/reference/objects/user) `object` [#decided-by]
The teammate who made the standing decision. Null when nobody has decided, and for a teammate who has left the workspace.

#### [`JobCandidate.decision`](#decision) · [`JobCandidateDecision`](/api/reference/enums/job-candidate-decision) `enum` [#decision]
The recruiter's standing call. Null when nobody has decided, or when a later stage change made the earlier call out of date.

#### [`JobCandidate.decisionReason`](#decision-reason) · [`String`](/api/reference/scalars/string) `scalar` [#decision-reason]
Why the recruiter decided as they did, in their words: what they typed, else what they said.

#### [`JobCandidate.grade`](#grade) · [`JobCandidateGrade`](/api/reference/enums/job-candidate-grade) `enum` [#grade]
How well the candidate fits the job: the recruiter's own grade when they set one, else the automatic assessment's. Null before any assessment.

#### [`JobCandidate.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The id of this place on the job. Not the candidate's id.

#### [`JobCandidate.interviews`](#interviews) · [`InterviewConnection!`](/api/reference/objects/interview-connection) `non-null` `object` [#interviews]
Appointments for this candidate on this job, earliest scheduled time first, then by id.
##### [`JobCandidate.interviews.after`](#job-candidate-interviews-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-candidate-interviews-after]
Return the rows that follow this cursor.

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

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

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

#### [`JobCandidate.isGradeOverridden`](#is-grade-overridden) · [`Boolean!`](/api/reference/scalars/boolean) `non-null` `scalar` [#is-grade-overridden]
True when a recruiter set `grade` by hand. The automatic assessment then leaves it alone.

#### [`JobCandidate.job`](#job) · [`Job!`](/api/reference/objects/job) `non-null` `object` [#job]
The job.

#### [`JobCandidate.latestNote`](#latest-note) · [`CandidateNote`](/api/reference/objects/candidate-note) `object` [#latest-note]
The newest note with words in it left about this candidate for this job. Null when there is none. General notes about the person are not counted.

#### [`JobCandidate.nextAction`](#next-action) · [`String`](/api/reference/scalars/string) `scalar` [#next-action]
What the recruiter means to do next for this candidate.

#### [`JobCandidate.nextActionDueAt`](#next-action-due-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#next-action-due-at]
When `nextAction` is due.

#### [`JobCandidate.notes`](#notes) · [`String`](/api/reference/scalars/string) `scalar` [#notes]
The recruiter's notes on the candidate for this job.

#### [`JobCandidate.offerAcceptedAt`](#offer-accepted-at) · [`Date`](/api/reference/scalars/date) `scalar` [#offer-accepted-at]
The day the candidate accepted the offer.

#### [`JobCandidate.offerSalary`](#offer-salary) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#offer-salary]
The salary offered, in `currency`.

#### [`JobCandidate.outreachDrafts`](#outreach-drafts) · [`OutreachDraftConnection!`](/api/reference/objects/outreach-draft-connection) `non-null` `object` [#outreach-drafts]
Outreach an agent drafted for them and stored for review, newest first. Empty unless the workspace runs the outreach agent.
##### [`JobCandidate.outreachDrafts.after`](#job-candidate-outreach-drafts-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-candidate-outreach-drafts-after]
Return the rows that follow this cursor.

##### [`JobCandidate.outreachDrafts.before`](#job-candidate-outreach-drafts-before) · [`String`](/api/reference/scalars/string) `scalar` [#job-candidate-outreach-drafts-before]
Return the rows that come before this cursor.

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

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

#### [`JobCandidate.owner`](#owner) · [`User`](/api/reference/objects/user) `object` [#owner]
The teammate responsible for this candidate on this job. Null when nobody is, and for a teammate who has left the workspace.

#### [`JobCandidate.placementFee`](#placement-fee) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#placement-fee]
The fee for placing them, in `currency`.

#### [`JobCandidate.placementVersion`](#placement-version) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#placement-version]
Changes when the placement's own details change (its stage, owner, offer, fee, currency, start, notes and the rest of the placement), and not when Kith ATS grades or re-ranks the place. Pass it back as `updatePlacement`'s `expectedVersion`.

#### [`JobCandidate.recruitingTasks`](#recruiting-tasks) · [`RecruitingTaskConnection!`](/api/reference/objects/recruiting-task-connection) `non-null` `object` [#recruiting-tasks]
Tasks specifically about this application, in id order.
##### [`JobCandidate.recruitingTasks.after`](#job-candidate-recruiting-tasks-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-candidate-recruiting-tasks-after]
Return the rows that follow this cursor.

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

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

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

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

#### [`JobCandidate.score`](#score) · [`Int`](/api/reference/scalars/int) `scalar` [#score]
The automatic assessment's score, from 0 to 100. Null before any assessment.

#### [`JobCandidate.signals`](#signals) · [`[JobCandidateSignal!]!`](/api/reference/objects/job-candidate-signal) `non-null` `object` [#signals]
The evidence behind the grade, for and against.

#### [`JobCandidate.stage`](#stage) · [`JobCandidateStage!`](/api/reference/enums/job-candidate-stage) `non-null` `enum` [#stage]
Where the candidate stands in the job's pipeline.

#### [`JobCandidate.startDate`](#start-date) · [`Date`](/api/reference/scalars/date) `scalar` [#start-date]
The day they start.

#### [`JobCandidate.submittedAt`](#submitted-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#submitted-at]
When the candidate was put forward to the client.

#### [`JobCandidate.summary`](#summary) · [`[JobCandidateSummaryPoint!]`](/api/reference/objects/job-candidate-summary-point) `list` `object` [#summary]
A written summary of the candidate for this job, up to four points. Null until one has been written.

#### [`JobCandidate.timelineNotes`](#timeline-notes) · [`CandidateNoteConnection!`](/api/reference/objects/candidate-note-connection) `non-null` `object` [#timeline-notes]
Notes about them for this job, the note written for a client share first, then the newest by when it was written. Notes about the person in general, and about their other jobs, are not here: read `Candidate.timelineNotes` for those.
##### [`JobCandidate.timelineNotes.after`](#job-candidate-timeline-notes-after) · [`String`](/api/reference/scalars/string) `scalar` [#job-candidate-timeline-notes-after]
Return the rows that follow this cursor.

##### [`JobCandidate.timelineNotes.before`](#job-candidate-timeline-notes-before) · [`String`](/api/reference/scalars/string) `scalar` [#job-candidate-timeline-notes-before]
Return the rows that come before this cursor.

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

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

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

#### [`JobCandidate.version`](#version) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#version]
Changes every time this place on the job changes. Read it with the row and pass it back where an operation asks for the version you acted on.

### Returned By [#returned-by]

[`jobCandidate`](/api/reference/queries/job-candidate)  `query`

### Member Of [#member-of]

[`AddedJobCandidate`](/api/reference/objects/added-job-candidate)  `object` · [`AuditEntry`](/api/reference/objects/audit-entry)  `object` · [`Interview`](/api/reference/objects/interview)  `object` · [`JobCandidateEdge`](/api/reference/objects/job-candidate-edge)  `object` · [`MoveJobCandidatePayload`](/api/reference/objects/move-job-candidate-payload)  `object` · [`OutreachDraft`](/api/reference/objects/outreach-draft)  `object` · [`RecruitingTask`](/api/reference/objects/recruiting-task)  `object` · [`RoleRecommendation`](/api/reference/objects/role-recommendation)  `object` · [`UpdateJobCandidateFollowUpPayload`](/api/reference/objects/update-job-candidate-follow-up-payload)  `object` · [`UpdatePlacementPayload`](/api/reference/objects/update-placement-payload)  `object`

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

These components show it:

- [Review card](/ui/candidate-review-card): One person against a role, with your actions.
- [Pipeline list](/ui/candidate-pipeline-list): The roles a person is in the pipeline for.
- [Assessment](/ui/candidate-assessment): A grade with its evidence and caveats.
- [Grade badge](/ui/candidate-grade): A grade letter with your own label and tone.
- [Shortlist](/ui/candidate-shortlist): People, a note from you, and a client decision.
- [Pipeline card](/ui/candidate-pipeline-card): A dense card for a board column.
- [Pipeline board](/ui/candidate-pipeline-board): A job's pipeline as a board, a column per stage.