List applications

get

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

Applications represent a candidate's journey on a specific job — the bridge between a candidate (person) and a job. Each candidate can have one application per job (and prospect applications can be jobless or attached to multiple prospective jobs). Scope the list with one of the parent-id arrays — candidate_ids, job_ids, job_post_ids, source_ids, referrer_ids, stage_ids, or prospective_job_ids — to filter by the matching foreign key. Pass ids directly to fetch specific applications by id (max 50 per request).

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

candidate_ids

array of integers

length ≤ 50

Comma separated list

candidate_ids

job_ids

array of integers

length ≤ 50

Return only applications attached to these job (hiring plan) ids. This is the application's current job, not any prospective placement — use prospective_job_ids for that.

job_ids

prospective_job_ids

array of integers

length ≤ 50

Return only applications that have a prospective placement on one of these job (hiring plan) ids. Prospective jobs are jobs a candidate is being considered for before being moved onto them; use job_ids to filter by the application's current job.

prospective_job_ids

job_post_ids

array of integers

length ≤ 50

Comma separated list

job_post_ids

source_ids

array of integers

length ≤ 50

Comma separated list

source_ids

referrer_ids

array of integers

length ≤ 50

Return only applications attributed to these referrer ids. A referrer is the Greenhouse Referrer record (see GET /v3/referrers) — not a user id. Look up the referrer id for a user via that endpoint first.

referrer_ids

stage_ids

array of integers

length ≤ 50

Return only applications whose current stage matches one of these stage IDs. These are application-stage IDs — the same value returned as stage_id on each application — not job interview stage definition IDs (IDs from GET /v3/job_interview_stages will not match).

stage_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

status

string

enum

Filter by the application's lifecycle status. active returns applications still in process; rejected and hired filter by terminal state.

Allowed:

stage_name

string

Filter applications by current stage name (exact match, case sensitive). Useful when you want to slice by stage without first looking up its id.

custom_field_option_id

integer

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

last_activity_at

object

Filter by last-activity timestamp on the application. 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).

prospect

boolean

When true, return only prospect applications; when false, only non-prospect (candidate) applications. Omit to include both.

Response

200Successful