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:
- Review card: One person against a role, with your actions.
- Pipeline list: The roles a person is in the pipeline for.
- Assessment: A grade with its evidence and caveats.
- Grade badge: A grade letter with your own label and tone.
- Shortlist: People, a note from you, and a client decision.
- Pipeline card: A dense card for a board column.
- Pipeline board: A job's pipeline as a board, a column per stage.