Search candidates

get

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

Search candidates through Greenhouse's full-text candidate search index, returning the same candidate shape as GET /v3/candidates with richer pipeline filters (job, stage, recruiter, coordinator, source, candidate tag, prospect pool, etc.). Use this when you need to slice across many filter dimensions at once or combine free-text matching with structured filters; for simple lookups by id or foreign key, prefer the list endpoint.

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 100

Defaults to 10

Number of results per page

ids

array of integers

length ≤ 50

Return only candidates with these person ids.

ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

string

Free-text search term.

tag

string

Filter by candidate tag name. Resolved to tag ids in the caller's organization; unknown tag returns no results. Use candidate_tag_id if you already have the id.

job_id

integer

Return only candidates with an application on this job.

status

string

enum

Restrict to candidates, prospects, or both. all returns both. Defaults to all.

Allowed:

job_status

string

enum

Filter by the lifecycle status of the candidate's job(s). all returns every status.

Allowed:

department_id

integer

Return only candidates whose job is in this department.

office_id

integer

Return only candidates whose job is in this office.

source_id

integer

Return only candidates attributed to this source.

recruiter_id

integer

Return only candidates whose job has this recruiter.

coordinator_id

integer

Return only candidates whose job has this coordinator.

hiring_manager_id

integer

Return only candidates whose job has this hiring manager.

stage_id

integer

Return only candidates currently in this interview stage (matches the stage on their active application).

stage_name

array of strings

length ≤ 50

Return only candidates currently in one of these interview stage names (exact match, case sensitive). Use alongside stage_id when you want name-based filtering without an extra id lookup.

stage_name

stage_status

string

enum

Filter by the candidate's current stage outcome (e.g. still in process, hired, rejected).

Allowed:

candidate_tag_id

integer

Filter by a specific candidate tag id. Prefer this over tag when the id is known to skip the name lookup.

job_post_id

integer

Return only candidates who applied via this job post.

prospect_pool_id

integer

Return only prospects in this prospect pool.

private

boolean

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

last_activity_at

object

Filter by last-activity timestamp. 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). Bounds are applied at day-level granularity in UTC; sub-day precision in the supplied timestamp is ignored. The range is always inclusive; gt/lt are accepted but applied identically to gte/lte.

Response

Language

Credentials

Loading…

Response

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

application/json

200Successful