# Kith ATS API reference (/ats/reference)

These pages are generated from the API's [schema](/schemas/ats.graphql), and say what the schema itself says. The API is being built domain by domain: they list what exists today.

## Queries [#queries]

- [`candidate`](/ats/reference/queries/candidate): One candidate by id, or null when the workspace has no such candidate.
- [`candidates`](/ats/reference/queries/candidates): The workspace's candidates, oldest first. Candidates still in Kith ATS's own sourcing review are not included.
- [`job`](/ats/reference/queries/job): One job by id, or null when the workspace has no such job.
- [`jobCandidate`](/ats/reference/queries/job-candidate): One candidate's place on a job, by that place's id, or null when the workspace has none with it.
- [`jobs`](/ats/reference/queries/jobs): The workspace's jobs, oldest first.
- [`viewer`](/ats/reference/queries/viewer): Who is making this request. Use it to check which workspace a key belongs to before writing.

## Objects [#objects]

- [`Candidate`](/ats/reference/objects/candidate): 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.
- [`CandidateConnection`](/ats/reference/objects/candidate-connection): A page of candidates.
- [`CandidateEdge`](/ats/reference/objects/candidate-edge): One candidate, with its cursor.
- [`Job`](/ats/reference/objects/job): A role a workspace is hiring for, with its brief. Candidates are worked against a job one by one: see `candidates`.
- [`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.
- [`JobCandidateConnection`](/ats/reference/objects/job-candidate-connection): A page of candidates' places on jobs.
- [`JobCandidateEdge`](/ats/reference/objects/job-candidate-edge): One place on a job, with its cursor.
- [`JobCandidateSignal`](/ats/reference/objects/job-candidate-signal): One piece of evidence about how a candidate fits a job, as shown beside their grade.
- [`JobCandidateSummaryPoint`](/ats/reference/objects/job-candidate-summary-point): One line of the written summary of a candidate for a job.
- [`JobConnection`](/ats/reference/objects/job-connection): A page of jobs.
- [`JobEdge`](/ats/reference/objects/job-edge): One job, with its cursor.
- [`PageInfo`](/ats/reference/objects/page-info): Where a page of a list starts and ends, and whether more follows.
- [`Viewer`](/ats/reference/objects/viewer): Who is making this request.
- [`Workspace`](/ats/reference/objects/workspace): A workspace: one recruiting team's jobs, candidates and settings. Every record belongs to exactly one.

## Inputs [#inputs]

- [`CandidateFilter`](/ats/reference/inputs/candidate-filter): Which candidates to list. Every condition given must hold.
- [`JobCandidateFilter`](/ats/reference/inputs/job-candidate-filter): Which candidates on a job to list. Every condition given must hold.
- [`JobFilter`](/ats/reference/inputs/job-filter): Which jobs to list. Every condition given must hold.

## Enums [#enums]

- [`CandidateActivityKind`](/ats/reference/enums/candidate-activity-kind): What the latest thing to happen with a candidate was.
- [`JobCandidateConfidence`](/ats/reference/enums/job-candidate-confidence): How sure the automatic assessment is of the grade it gave.
- [`JobCandidateDecision`](/ats/reference/enums/job-candidate-decision): A recruiter's standing call on a candidate for a job.
- [`JobCandidateGrade`](/ats/reference/enums/job-candidate-grade): How well a candidate fits a job.
- [`JobCandidateStage`](/ats/reference/enums/job-candidate-stage): Where a candidate stands in a job's pipeline. The stages run in the order listed, with three ways out.
- [`JobSearchStatus`](/ats/reference/enums/job-search-status): How far the search for a job has got, for a team that tracks its searches as business.
- [`JobStatus`](/ats/reference/enums/job-status): Whether a job is being worked.
- [`SignalKind`](/ats/reference/enums/signal-kind): Which part of the job's brief a signal was matched against.
- [`SignalSentiment`](/ats/reference/enums/signal-sentiment): Whether a signal counts for or against a candidate.
- [`SummaryPointKind`](/ats/reference/enums/summary-point-kind): What a summary point is about.
- [`SummaryPointSentiment`](/ats/reference/enums/summary-point-sentiment): Whether a summary point is good news, bad news or neither.

## Scalars [#scalars]

- [`Boolean`](/ats/reference/scalars/boolean): The `Boolean` scalar type represents `true` or `false`.
- [`DateTime`](/ats/reference/scalars/date-time): A moment in time, as an ISO 8601 string in UTC, such as `2026-11-16T09:30:00.000Z`.
- [`ID`](/ats/reference/scalars/id): The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.
- [`Int`](/ats/reference/scalars/int): The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
- [`String`](/ats/reference/scalars/string): The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.