The API is being built domain by domain. The reference shows what exists today.
Skip to Content
KITHDocs
ReferenceObjects

JobCandidate

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.

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

JobCandidate.adjustedScore · Int scalar

The score from 0 to 100 after it was re-ranked against the recruiter's own criteria, when they have recorded any.

JobCandidate.assessedGrade · JobCandidateGrade enum

The grade the automatic assessment last gave, kept even when a recruiter has set grade themselves.

JobCandidate.candidate · Candidate! non-null object

The candidate.

JobCandidate.confidence · JobCandidateConfidence enum

How sure the automatic assessment is of its grade.

JobCandidate.createdAt · DateTime! non-null scalar

When the candidate was added to the job.

JobCandidate.decidedAt · DateTime scalar

When the standing decision was made.

JobCandidate.decision · JobCandidateDecision enum

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

Why the recruiter decided as they did, in their words.

JobCandidate.grade · JobCandidateGrade enum

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! non-null scalar

The id of this place on the job. Not the candidate's id.

JobCandidate.isGradeOverridden · Boolean! non-null scalar

True when a recruiter set grade by hand. The automatic assessment then leaves it alone.

JobCandidate.job · Job! non-null object

The job.

JobCandidate.nextAction · String scalar

What the recruiter means to do next for this candidate.

JobCandidate.nextActionDueAt · DateTime scalar

When nextAction is due.

JobCandidate.notes · String scalar

The recruiter's notes on the candidate for this job.

JobCandidate.score · Int scalar

The automatic assessment's score, from 0 to 100. Null before any assessment.

JobCandidate.signals · [JobCandidateSignal!]! non-null object

The evidence behind the grade, for and against.

JobCandidate.stage · JobCandidateStage! non-null enum

Where the candidate stands in the job's pipeline.

JobCandidate.submittedAt · DateTime scalar

When the candidate was put forward to the client.

JobCandidate.summary · [JobCandidateSummaryPoint!] list object

A written summary of the candidate for this job, up to four points. Null until one has been written.

JobCandidate.updatedAt · DateTime! non-null scalar

When this place on the job last changed.

Returned By

jobCandidate query

Member Of

JobCandidateEdge object

On this page