Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Close Reasons

List close reasons

Close reasons are the organization-defined dictionary of outcomes recorded when an opening is closed (e.g. Hire - New Headcount, Hire - Backfill, On Hold, Not Filling). Each closed opening references a single close reason via close_reason_id; resolve the human-readable label here. Customized per organization under Configure > Custom Options > Close Reasons for Job Openings, so the available set varies between Greenhouse accounts. Distinct from rejection_reasons, which apply to candidate applications rather than to openings.

get/v3/close_reasons

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
fieldsstring[]

Comma separated list of fields to return

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
namestring

Display label shown to recruiters and hiring managers when closing an opening (e.g. Hire - New Headcount, Hire - Backfill, On Hold, Not Filling). Unique within the organization. Names that start with Hire - are treated as hire outcomes in Greenhouse reporting; other names are non-hire outcomes. Free-text, since each organization customizes its own list under Configure > Custom Options > Close Reasons for Job Openings.