# JobCandidate (/ats/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
  createdAt: DateTime!
  decidedAt: DateTime
  decision: JobCandidateDecision
  decisionReason: String
  grade: JobCandidateGrade
  id: ID!
  isGradeOverridden: Boolean!
  job: Job!
  nextAction: String
  nextActionDueAt: DateTime
  notes: String
  score: Int
  signals: [JobCandidateSignal!]!
  stage: JobCandidateStage!
  submittedAt: DateTime
  summary: [JobCandidateSummaryPoint!]
  updatedAt: DateTime!
}
```

### Fields [#fields]

#### [`JobCandidate.adjustedScore`](#adjusted-score) · [`Int`](/ats/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`](/ats/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!`](/ats/reference/objects/candidate) `non-null` `object` [#candidate]
The candidate.

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

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

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

#### [`JobCandidate.decision`](#decision) · [`JobCandidateDecision`](/ats/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`](/ats/reference/scalars/string) `scalar` [#decision-reason]
Why the recruiter decided as they did, in their words.

#### [`JobCandidate.grade`](#grade) · [`JobCandidateGrade`](/ats/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!`](/ats/reference/scalars/id) `non-null` `scalar` [#id]
The id of this place on the job. Not the candidate's id.

#### [`JobCandidate.isGradeOverridden`](#is-grade-overridden) · [`Boolean!`](/ats/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!`](/ats/reference/objects/job) `non-null` `object` [#job]
The job.

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

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

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

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

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

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

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

#### [`JobCandidate.summary`](#summary) · [`[JobCandidateSummaryPoint!]`](/ats/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.updatedAt`](#updated-at) · [`DateTime!`](/ats/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When this place on the job last changed.

### Returned By [#returned-by]

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

### Member Of [#member-of]

[`JobCandidateEdge`](/ats/reference/objects/job-candidate-edge)  `object`