List all Candidates

get

https://api.getknit.dev/v1.0/ats.candidate.list

List candidates in a paginated format with details such as id, firstName, lastName, emails, etc.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
For schema of candidate object refer - Candidate Data Model
This API may not return all fields defined in the response schema; for additional details, use the Get Candidate by Id API.

Supported Apps

Apps supported via API

Zoho Recruit (zoho-recruit)

Vincere (vincere)

BambooHR ATS (bamboohr-ats)

JobAdder (jobadder)

UKG Pro Recruiting (ukgpro-ats)

Lever (lever)

HR Works ATS (hr-works-ats)

iCIMS (icims)

Breezy (breezy)

jobId is required field.

JazzHR ATS (jazzhr-ats)

Greenhouse (greenhouse)

Workable (workable)

JobDiva (jobdiva)

SuccessFactors ATS (successfactors-ats)

TeamTailor (teamtailor)

Keka ATS (keka-ats)

Recruitee (recruitee)

Ashby (ashby)

Oracle HCM ATS (oracle-hcm-ats)

Workday ATS (workday-ats)

Pinpoint (pinpoint)

Recruiterflow (recruiterflow)

Recruit CRM ATS (recruit-crm-ats)

Loxo (loxo)

Jobvite (jobvite)

ERPNext ATS (erpnext-ats)

Personio ATS (personio-ats)

To see the list of supported filters for an app, refer - ATS List Candidates Filter Support Matrix

Query Params

pageToken

string

originData

boolean

Defaults to false

createdAfter

date-time

Filters candidates who were created after the specified datetime.
The datetime must be provided in ISO 8601 UTC format (yyyy-MM-dd'T'HH:mm:ss'Z').

createdBefore

date-time

Filters candidates who were created before the specified datetime.
The datetime must be provided in ISO 8601 UTC format (yyyy-MM-dd'T'HH:mm:ss'Z').

updatedAfter

date-time

Filters candidates who were updated after the specified datetime.
The datetime must be provided in ISO 8601 UTC format (yyyy-MM-dd'T'HH:mm:ss'Z').

updatedBefore

date-time

Filters candidates who were updated before the specified datetime.
The datetime must be provided in ISO 8601 UTC format (yyyy-MM-dd'T'HH:mm:ss'Z').

jobId

string

Filters candidates by one or more job IDs. Supports multiple values as a comma-separated list. (e.g., jobId=24,18,25).

string

Filters candidates by their email address. Supports multiple values as a comma-separated list.
Example: email=[email protected],[email protected]

tag

string

Filters candidates by one or more assigned tags. Supports multiple values as a comma-separated list.
Example: tag=Technical,Remote,Urgent-Hire

Responses

Supported Apps

200

400Bad Request