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.

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

Language

Credentials

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200