New: Kith open-sources its ATS.Read why
Skip to Content
Objects

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
  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

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.contactChannels · [JobCandidateContact!]! non-null object

Which channels the candidate has been contacted on for this job, each with its latest touch.

JobCandidate.createdAt · DateTime! non-null scalar

When the candidate was added to the job.

JobCandidate.currency · String! non-null scalar

The currency of offerSalary and placementFee, as a three-letter ISO 4217 code such as GBP.

JobCandidate.decidedAt · DateTime scalar

When the standing decision was made.

JobCandidate.decidedBy · User object

The teammate who made the standing decision. Null when nobody has decided, and for a teammate who has left the workspace.

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: what they typed, else what they said.

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.interviews · InterviewConnection! non-null object

Appointments for this candidate on this job, earliest scheduled time first, then by id.

JobCandidate.interviews.after · String scalar

Return the rows that follow this cursor.

JobCandidate.interviews.before · String scalar

Return the rows that come before this cursor.

JobCandidate.interviews.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

JobCandidate.interviews.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

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.latestNote · CandidateNote object

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 · 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.offerAcceptedAt · Date scalar

The day the candidate accepted the offer.

JobCandidate.offerSalary · Decimal scalar

The salary offered, in currency.

JobCandidate.outreachDrafts · OutreachDraftConnection! non-null object

Outreach an agent drafted for them and stored for review, newest first. Empty unless the workspace runs the outreach agent.

JobCandidate.outreachDrafts.after · String scalar

Return the rows that follow this cursor.

JobCandidate.outreachDrafts.before · String scalar

Return the rows that come before this cursor.

JobCandidate.outreachDrafts.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

JobCandidate.outreachDrafts.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

JobCandidate.owner · User object

The teammate responsible for this candidate on this job. Null when nobody is, and for a teammate who has left the workspace.

JobCandidate.placementFee · Decimal scalar

The fee for placing them, in currency.

JobCandidate.placementVersion · String! non-null scalar

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 · RecruitingTaskConnection! non-null object

Tasks specifically about this application, in id order.

JobCandidate.recruitingTasks.after · String scalar

Return the rows that follow this cursor.

JobCandidate.recruitingTasks.before · String scalar

Return the rows that come before this cursor.

JobCandidate.recruitingTasks.filter · RecruitingTaskFilter input

Narrow the tasks on this application.

JobCandidate.recruitingTasks.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

JobCandidate.recruitingTasks.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

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.startDate · Date scalar

The day they start.

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.timelineNotes · CandidateNoteConnection! non-null object

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

Return the rows that follow this cursor.

JobCandidate.timelineNotes.before · String scalar

Return the rows that come before this cursor.

JobCandidate.timelineNotes.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

JobCandidate.timelineNotes.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

JobCandidate.updatedAt · DateTime! non-null scalar

When this place on the job last changed.

JobCandidate.version · String! non-null scalar

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

jobCandidate query

Member Of

AddedJobCandidate object · AuditEntry object · Interview object · JobCandidateEdge object · MoveJobCandidatePayload object · OutreachDraft object · RecruitingTask object · RoleRecommendation object · UpdateJobCandidateFollowUpPayload object · UpdatePlacementPayload object

Shown in the UI

These components show it:

On this page

FieldsJobCandidate.adjustedScore · Int scalarJobCandidate.assessedGrade · JobCandidateGrade enumJobCandidate.candidate · Candidate! non-null objectJobCandidate.confidence · JobCandidateConfidence enumJobCandidate.contactChannels · [JobCandidateContact!]! non-null objectJobCandidate.createdAt · DateTime! non-null scalarJobCandidate.currency · String! non-null scalarJobCandidate.decidedAt · DateTime scalarJobCandidate.decidedBy · User objectJobCandidate.decision · JobCandidateDecision enumJobCandidate.decisionReason · String scalarJobCandidate.grade · JobCandidateGrade enumJobCandidate.id · ID! non-null scalarJobCandidate.interviews · InterviewConnection! non-null objectJobCandidate.interviews.after · String scalarJobCandidate.interviews.before · String scalarJobCandidate.interviews.first · Int scalarJobCandidate.interviews.last · Int scalarJobCandidate.isGradeOverridden · Boolean! non-null scalarJobCandidate.job · Job! non-null objectJobCandidate.latestNote · CandidateNote objectJobCandidate.nextAction · String scalarJobCandidate.nextActionDueAt · DateTime scalarJobCandidate.notes · String scalarJobCandidate.offerAcceptedAt · Date scalarJobCandidate.offerSalary · Decimal scalarJobCandidate.outreachDrafts · OutreachDraftConnection! non-null objectJobCandidate.outreachDrafts.after · String scalarJobCandidate.outreachDrafts.before · String scalarJobCandidate.outreachDrafts.first · Int scalarJobCandidate.outreachDrafts.last · Int scalarJobCandidate.owner · User objectJobCandidate.placementFee · Decimal scalarJobCandidate.placementVersion · String! non-null scalarJobCandidate.recruitingTasks · RecruitingTaskConnection! non-null objectJobCandidate.recruitingTasks.after · String scalarJobCandidate.recruitingTasks.before · String scalarJobCandidate.recruitingTasks.filter · RecruitingTaskFilter inputJobCandidate.recruitingTasks.first · Int scalarJobCandidate.recruitingTasks.last · Int scalarJobCandidate.score · Int scalarJobCandidate.signals · [JobCandidateSignal!]! non-null objectJobCandidate.stage · JobCandidateStage! non-null enumJobCandidate.startDate · Date scalarJobCandidate.submittedAt · DateTime scalarJobCandidate.summary · [JobCandidateSummaryPoint!] list objectJobCandidate.timelineNotes · CandidateNoteConnection! non-null objectJobCandidate.timelineNotes.after · String scalarJobCandidate.timelineNotes.before · String scalarJobCandidate.timelineNotes.first · Int scalarJobCandidate.timelineNotes.last · Int scalarJobCandidate.updatedAt · DateTime! non-null scalarJobCandidate.version · String! non-null scalarReturned ByMember OfShown in the UI