List candidates

get

https://harvest.greenhouse.io/v3/candidates

Candidates are the people your organization is recruiting — both active applicants and prospects. A candidate record holds the personal profile (names, contact methods, tags, custom fields) and is the parent of one or more applications, each of which represents the candidate's journey on a specific job. Use the ids query parameter to fetch a single candidate by id; nested data (applications, attachments, educations, employments) lives on its own resource endpoint in V3.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

cursor

string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_page

integer

1 to 500

Defaults to 100

Number of results per page

ids

array of integers

length ≤ 50

Comma separated list

ids

created_at

object

updated_at

object

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

last_activity_at

object

Filter by last-activity timestamp on the candidate's applications. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times (e.g. last_activity_at[gte]=2026-01-01T00:00:00Z&last_activity_at[lte]=2026-04-01T00:00:00Z).

custom_field_option_id

integer

Return only candidates whose custom field value matches this single-select or multi-select option id.

private

boolean

Include private candidates the caller has access to. Defaults to true; set false to exclude private candidates.

string

Return only candidates with this email address on their profile. Matches against any of the candidate's email addresses, case-insensitively.

tag

string

Filter by candidate tag name (exact match). Use the /v3/candidate_tags endpoint to discover available tag names for your organization.

Response

Language

Credentials

Loading…

Response

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

application/json

200Successful