""" A person a workspace knows as a possible hire. They are in the workspace's records whether or not they are on a job: see `jobs` for the jobs they are on. """ type Candidate { """The banner image from their profile.""" bannerUrl: String """When they were added to the workspace.""" createdAt: DateTime! """The name of the company they work at today.""" currentCompany: String """Their job title today.""" currentTitle: String """A link to their CV.""" cvUrl: String """Their email address.""" email: String """When the workspace marked them as exceptional. Null when it has not.""" favouritedAt: DateTime """The candidate's id, as in their URL in the app.""" id: ID! """True when they have been put away and are left out of everyday lists.""" isArchived: Boolean! """ True when an enrichment provider confirmed the email address reaches them. """ isEmailVerified: Boolean! """ The jobs they are on, each with their stage, grade and decision there, in the order they were added. """ jobs( """Return the rows that follow this cursor.""" after: String """Return the rows that come before this cursor.""" before: String """ How many rows to return, from the start or from `after`. 50 when left out, 200 at most. """ first: Int """ How many rows to return, counting back from the end or from `before`. 200 at most. """ last: Int ): JobCandidateConnection! """ When anything last happened with them: a note, a call, a stage move or a decision. """ lastActivityAt: DateTime """What that latest thing was.""" lastActivityKind: CandidateActivityKind """When the latest recorded call with them took place.""" lastCallAt: DateTime """The title of that latest call.""" lastCallTitle: String """When someone last left a note about them.""" lastNoteAt: DateTime """Their LinkedIn profile.""" linkedinUrl: String """Where they are based, as written on their profile.""" location: String """The city from `location`, when it could be worked out.""" locationCity: String """ The country from `location`, as a two-letter ISO 3166 code such as `GB`. """ locationCountryCode: String """ The state, county or region from `location`, when it could be worked out. """ locationRegion: String """Their full name.""" name: String! """General notes about them, apart from any job.""" notes: String """Their phone number, as it was entered.""" phone: String """A photo of them.""" photoUrl: String """What they earn or expect, as it was written down.""" salary: String """ How they came to be in the workspace, such as an import or the browser extension. """ source: String """The workspace's own labels for them.""" tags: [String!]! """When their record last changed.""" updatedAt: DateTime! """How many years they have worked.""" yearsExperience: Int } """What the latest thing to happen with a candidate was.""" enum CandidateActivityKind { """A call with them was recorded.""" CALL """A recruiter decided on them for a job.""" DECISION """Someone left a note.""" NOTE """They moved stage on a job.""" STAGE } """A page of candidates.""" type CandidateConnection { """The rows of this page, each with its cursor.""" edges: [CandidateEdge!]! """Whether there is more to read, and from where.""" pageInfo: PageInfo! } """One candidate, with its cursor.""" type CandidateEdge { """ Where this row sits in the list. Pass it as `after` to read on from here. """ cursor: String! """The row.""" node: Candidate! } """Which candidates to list. Every condition given must hold.""" input CandidateFilter { """Only candidates with one of these email addresses. 200 at most.""" emails: [String!] """Only these candidates. 200 at most.""" ids: [ID!] """ True for archived candidates only, false for the rest. Left out, both are returned. """ isArchived: Boolean """ Only candidates with one of these LinkedIn profile URLs, matched exactly as stored. 200 at most. """ linkedinUrls: [String!] """ Only candidates whose name, current title or current company contains this text, exactly as written but in any case. 200 characters at most. """ search: String } """ A moment in time, as an ISO 8601 string in UTC, such as `2026-11-16T09:30:00.000Z`. """ scalar DateTime """ A role a workspace is hiring for, with its brief. Candidates are worked against a job one by one: see `candidates`. """ type Job { """ The candidates on this job, each with their stage, grade and decision, in the order they were added. Candidates still in Kith ATS's own sourcing review are not included. """ candidates( """Return the rows that follow this cursor.""" after: String """Return the rows that come before this cursor.""" before: String """Narrow the list. Left out, every candidate on the job is returned.""" filter: JobCandidateFilter """ How many rows to return, from the start or from `after`. 50 when left out, 200 at most. """ first: Int """ How many rows to return, counting back from the end or from `before`. 200 at most. """ last: Int ): JobCandidateConnection! """The hiring company, as the brief names it.""" companyName: String """The hiring company's website, as `https://` and its public domain.""" companyWebsite: String """When the job was created.""" createdAt: DateTime! """The role, described in prose. May be long.""" description: String """The job's id, as in its URL in the app.""" id: ID! """ Where the role is based, as the brief says it: a city, a region, "Remote". """ location: String """ What a candidate must have to be considered, one requirement per entry. """ mustHaves: [String!]! """What counts in a candidate's favour without being required.""" niceToHaves: [String!]! """What rules a candidate out, or counts against them.""" redFlags: [String!]! """ The top of the base salary range, in whole units of the role's currency. """ salaryMax: Int """ The bottom of the base salary range, in whole units of the role's currency. """ salaryMin: Int """ How far the search has got, when the team tracks it. Null when it does not. """ searchStatus: JobSearchStatus """Whether the job is being worked.""" status: JobStatus! """The role's title, such as "Founding Account Executive".""" title: String! """When the job itself last changed.""" updatedAt: DateTime! } """ 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 { """ The score from 0 to 100 after it was re-ranked against the recruiter's own criteria, when they have recorded any. """ adjustedScore: Int """ The grade the automatic assessment last gave, kept even when a recruiter has set `grade` themselves. """ assessedGrade: JobCandidateGrade """The candidate.""" candidate: Candidate! """How sure the automatic assessment is of its grade.""" confidence: JobCandidateConfidence """When the candidate was added to the job.""" createdAt: DateTime! """When the standing decision was made.""" decidedAt: DateTime """ The recruiter's standing call. Null when nobody has decided, or when a later stage change made the earlier call out of date. """ decision: JobCandidateDecision """Why the recruiter decided as they did, in their words.""" decisionReason: String """ 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. """ grade: JobCandidateGrade """The id of this place on the job. Not the candidate's id.""" id: ID! """ True when a recruiter set `grade` by hand. The automatic assessment then leaves it alone. """ isGradeOverridden: Boolean! """The job.""" job: Job! """What the recruiter means to do next for this candidate.""" nextAction: String """When `nextAction` is due.""" nextActionDueAt: DateTime """The recruiter's notes on the candidate for this job.""" notes: String """ The automatic assessment's score, from 0 to 100. Null before any assessment. """ score: Int """The evidence behind the grade, for and against.""" signals: [JobCandidateSignal!]! """Where the candidate stands in the job's pipeline.""" stage: JobCandidateStage! """When the candidate was put forward to the client.""" submittedAt: DateTime """ A written summary of the candidate for this job, up to four points. Null until one has been written. """ summary: [JobCandidateSummaryPoint!] """When this place on the job last changed.""" updatedAt: DateTime! } """How sure the automatic assessment is of the grade it gave.""" enum JobCandidateConfidence { """The evidence is clear either way.""" HIGH """Too little evidence: a person should read the profile and decide.""" LOW """The evidence mostly points one way.""" MEDIUM } """A page of candidates' places on jobs.""" type JobCandidateConnection { """The rows of this page, each with its cursor.""" edges: [JobCandidateEdge!]! """Whether there is more to read, and from where.""" pageInfo: PageInfo! } """A recruiter's standing call on a candidate for a job.""" enum JobCandidateDecision { """Not for this job.""" NO """Looked at and left undecided.""" SKIP """Take them forward.""" YES } """One place on a job, with its cursor.""" type JobCandidateEdge { """ Where this row sits in the list. Pass it as `after` to read on from here. """ cursor: String! """The row.""" node: JobCandidate! } """Which candidates on a job to list. Every condition given must hold.""" input JobCandidateFilter { """Only these candidates, by their ids. 200 at most.""" candidateIds: [ID!] """Only candidates with one of these decisions.""" decisions: [JobCandidateDecision!] """Only candidates with one of these grades.""" grades: [JobCandidateGrade!] """Only candidates at one of these stages.""" stages: [JobCandidateStage!] } """How well a candidate fits a job.""" enum JobCandidateGrade { """A strong fit: worth headhunting.""" A """A good fit.""" B """A possible fit: worth a screening call.""" C """Not a fit.""" REJECT } """ One piece of evidence about how a candidate fits a job, as shown beside their grade. """ type JobCandidateSignal { """ The part of the brief it was matched against, when it was matched against one. """ kind: SignalKind """The words in the profile that produced the match.""" matchedValue: String """Whether it counts for or against the candidate.""" sentiment: SignalSentiment! """ The part of the candidate's profile the evidence came from, such as `currentTitle`. """ sourceField: String """The evidence, in a sentence.""" text: String! } """ Where a candidate stands in a job's pipeline. The stages run in the order listed, with three ways out. """ enum JobCandidateStage { """Reached out to, with no reply yet.""" CONTACTED """The candidate withdrew or was not interested.""" DECLINED """Accepted the offer. This is a placement.""" HIRED """In the client's interview process.""" INTERVIEWING """Reviewed and worth pursuing.""" LONGLIST """Has an offer.""" OFFERED """Ruled out by the recruiter or the client.""" REJECTED """Has answered the outreach.""" REPLIED """Has had a screening conversation.""" SCREENED """Put forward to the client.""" SHORTLISTED """Newly added to the job and waiting for a first review.""" SOURCED } """One line of the written summary of a candidate for a job.""" type JobCandidateSummaryPoint { """What the point is about.""" kind: SummaryPointKind! """Whether it is good news, bad news or neither.""" sentiment: SummaryPointSentiment! """The point, in a sentence.""" text: String! } """A page of jobs.""" type JobConnection { """The rows of this page, each with its cursor.""" edges: [JobEdge!]! """Whether there is more to read, and from where.""" pageInfo: PageInfo! } """One job, with its cursor.""" type JobEdge { """ Where this row sits in the list. Pass it as `after` to read on from here. """ cursor: String! """The row.""" node: Job! } """Which jobs to list. Every condition given must hold.""" input JobFilter { """Only jobs in one of these statuses.""" statuses: [JobStatus!] } """ How far the search for a job has got, for a team that tracks its searches as business. """ enum JobSearchStatus { """The search ended without a placement.""" CLOSED_UNFILLED """No sourcing has begun.""" NOT_STARTED """A candidate has an offer.""" OFFER_OUT """A candidate accepted and the role is filled.""" PLACED """Candidates are being sourced.""" SEARCHING """A shortlist is ready for the client.""" SHORTLIST_READY } """Whether a job is being worked.""" enum JobStatus { """Put away. Kept for its history and left out of everyday lists.""" ARCHIVED """Finished, filled or not.""" CLOSED """Still being written. Not yet worked.""" DRAFT """Being worked: candidates can be added and moved through its pipeline.""" OPEN } """Where a page of a list starts and ends, and whether more follows.""" type PageInfo { """ The cursor of the page's last row, or null for an empty page. Pass it as `after` for the next page. """ endCursor: String """True when rows follow this page.""" hasNextPage: Boolean! """True when rows come before this page.""" hasPreviousPage: Boolean! """The cursor of the page's first row, or null for an empty page.""" startCursor: String } """Everything that can be read.""" type Query { """One candidate by id, or null when the workspace has no such candidate.""" candidate( """The candidate's id.""" id: ID! ): Candidate """ The workspace's candidates, oldest first. Candidates still in Kith ATS's own sourcing review are not included. """ candidates( """Return the rows that follow this cursor.""" after: String """Return the rows that come before this cursor.""" before: String """ Narrow the list. Left out, every candidate is returned, archived ones included. """ filter: CandidateFilter """ How many rows to return, from the start or from `after`. 50 when left out, 200 at most. """ first: Int """ How many rows to return, counting back from the end or from `before`. 200 at most. """ last: Int ): CandidateConnection! """One job by id, or null when the workspace has no such job.""" job( """The job's id.""" id: ID! ): Job """ One candidate's place on a job, by that place's id, or null when the workspace has none with it. """ jobCandidate( """The id of the place on the job.""" id: ID! ): JobCandidate """The workspace's jobs, oldest first.""" jobs( """Return the rows that follow this cursor.""" after: String """Return the rows that come before this cursor.""" before: String """Narrow the list. Left out, every job is returned, whatever its status.""" filter: JobFilter """ How many rows to return, from the start or from `after`. 50 when left out, 200 at most. """ first: Int """ How many rows to return, counting back from the end or from `before`. 200 at most. """ last: Int ): JobConnection! """ Who is making this request. Use it to check which workspace a key belongs to before writing. """ viewer: Viewer! } """Which part of the job's brief a signal was matched against.""" enum SignalKind { """One of the job's must-haves.""" MUST_HAVE """One of the job's nice-to-haves.""" NICE_TO_HAVE """One of the job's red flags.""" RED_FLAG } """Whether a signal counts for or against a candidate.""" enum SignalSentiment { """Worth checking: neither clearly for nor against.""" AMBER """Counts in the candidate's favour.""" GREEN """Counts against the candidate.""" RED } """What a summary point is about.""" enum SummaryPointKind { """Background worth knowing, apart from fit.""" CONTEXT """How the candidate fits the job.""" FIT } """Whether a summary point is good news, bad news or neither.""" enum SummaryPointSentiment { """Against the candidate.""" NEGATIVE """Neither for nor against.""" NEUTRAL """In the candidate's favour.""" POSITIVE } """Who is making this request.""" type Viewer { """ The workspace the request acts in. Everything this API returns belongs to it. """ workspace: Workspace! } """ A workspace: one recruiting team's jobs, candidates and settings. Every record belongs to exactly one. """ type Workspace { """The workspace's id.""" id: ID! """The workspace's name, as its members see it.""" name: String! """A short, unique name for the workspace, safe to use in a URL.""" slug: String! }