Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Applications

List 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).

get/v3/applications

Query parameters

cursorstring

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

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
candidate_idsinteger[]

Comma separated list

job_idsinteger[]

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.

prospective_job_idsinteger[]

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.

job_post_idsinteger[]

Comma separated list

source_idsinteger[]

Comma separated list

referrer_idsinteger[]

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.

stage_idsinteger[]

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).

job_interview_stage_idsinteger[]

Return only applications whose current job interview stage matches one of these stage IDs. These are job interview stage definition IDs (IDs from GET /v3/job_interview_stages).

fieldsstring[]

Comma separated list of fields to return

status'rejected' | 'hired' | 'converted' | 'active'

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

stage_namestring

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_idinteger

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

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time

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).

prospectboolean

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

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
agency_note_idinteger nullable

Id of the note created when the candidate was submitted by an agency, or null if the application did not come through an agency.

candidate_idinteger

Id of the candidate (person) this application belongs to.

coordinator_idinteger nullable

Id of the user assigned as coordinator on the application's job, or null when unassigned.

job_idinteger nullable

Id of the job this application is on. null for jobless prospect applications.

job_post_idinteger nullable

Id of the job post the candidate applied through, or null if the application was created internally rather than from a posted role.

recruiter_idinteger nullable

Id of the user assigned as recruiter on the application's job, or null when unassigned.

referrer_idinteger nullable

Id of the referrer who credited this application, or null if there was no referral. References a referrer, not a Greenhouse user.

source_idinteger nullable

Id of the source the application is attributed to (e.g. a job board, an event, an employee referral source). null if no source is set.

stage_idinteger nullable

Id of the interview stage the candidate is currently in for this application. null for prospect applications and applications in a terminal state.

job_interview_stage_idinteger nullable

Id of the job interview stage definition (see GET /v3/job_interview_stages) the candidate is currently in for this application. null for prospect applications and applications in a terminal state.

stage_namestring nullable

Display name of the candidate's current interview stage on this application.

status'rejected' | 'hired' | 'converted' | 'in_process'

Lifecycle status of the application. in_process for active candidates, rejected for rejected applications, hired once an offer is closed and the hire endpoint has fired, and converted for prospect applications that have been promoted to a candidate application via convert_to_candidate.

needs_decisionboolean nullable

true when the application is waiting on a hiring-team decision (scorecard completion, advance/reject, etc.) in its current stage.

prospectboolean

true for prospect applications (sourced candidates not yet attached to a single job), false for candidate applications on a specific job.

rejected_atstring date-time nullable

Timestamp the application was rejected, in ISO 8601. null for applications that have not been rejected.

last_activity_atstring date-time nullable

Timestamp of the most recent activity on this application (notes, emails, stage changes, etc.), in ISO 8601.

location_addressstring nullable

Free-form location string captured on the application (typically from the job post's location question).

prospective_job_idsinteger[]

For prospect applications, the ids of jobs the prospect is being considered for. Empty for non-prospect applications and for jobless prospects.

custom_fieldsobject nullable