List openings

get

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

Openings are the individual headcount slots beneath a job — one opening per seat you intend to hire for. Each opening is filled when a candidate is hired against it (status becomes closed and application_id is populated) or closed without a hire (with a close_reason_id); closing the last open opening on a job automatically closes the job. Filter by parent (job_id, application_id, close_reason_id), by partner-supplied opening_id, by open/closed state, or by an opened_at / closed_at window for incremental HRIS-style syncs.

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

job_ids

array of integers

length ≤ 50

Return only openings on these job (hiring plan) ids. Openings represent headcount on a job, so this filters to the openings belonging to those jobs.

job_ids

application_ids

array of integers

length ≤ 50

Return only openings currently filled by these application ids. An opening's application_id is set when a candidate's application is moved onto the opening; null while the opening is still unfilled.

application_ids

close_reason_ids

array of integers

length ≤ 50

Return only openings closed with one of these close_reason ids (e.g. Hire - New Headcount, On Hold, Requisition Cancelled). Resolve ids via GET /v3/close_reasons. Open openings have no close_reason_id and will not match.

close_reason_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

opened_at

object

Filter by the timestamp the opening transitioned to open. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times (e.g. opened_at[gte]=2026-01-01T00:00:00Z).

closed_at

object

Filter by the timestamp the opening was closed. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times. Useful for incrementally syncing recently filled or cancelled headcount.

custom_field_option_id

integer

Return only openings that have this custom_field_option id selected on any of their single- or multi-select opening custom fields.

open

boolean

When true, return only openings that are still available to be filled; when false, only openings that have been closed. Omit to return both.

opening_id

string

Return only openings whose partner-supplied opening_id matches exactly. Not unique across the organization — multiple openings may share an opening_id.

Response

200Successful