GRgreenhouse
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

Request

  • Base URL
    https://harvest.greenhouse.io
  • URL
    https://harvest.greenhouse.io/v3/close_reasons
  • Auth
    • OAuth 2
      Authorization code: https://auth.greenhouse.io/authorize
      Client credentials
      Token URL: https://auth.greenhouse.io/token scopes: harvest:close_reasons:list
    • or HTTP bearer

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.

Changes

No recorded changes to this operation across all 1 revision of this API.