v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Rejection Reasons

List rejection reasons

Rejection reasons are the organization-defined dictionary of outcomes recorded when an application is rejected (e.g. Not a cultural fit, Lacking skill(s)/qualification(s), Wasn't interested, Didn't like offer, Spam). Each rejected application references one of these through its rejection_details.rejection_reason; this endpoint is the source of truth for the picklist itself. Reasons are grouped under a type of We rejected them, They rejected us, None specified, or Security concern — use the type to distinguish the organization declining the candidate from the candidate withdrawing, and to identify trust/fraud outcomes in reporting. Customized per organization under Configure > Custom Options > Rejection Reasons, so the available set varies between Greenhouse accounts; pass include_defaults=true to also return the standard reasons that ship with every account. Reasons of type Security concern are only returned when the enable_reject_as_security_concern product flag is on. Distinct from rejection_details, which carries the per-application rejection instance attached to a rejected application, and from close_reasons, which apply to openings rather than applications.

get/v3/rejection_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

include_defaultsboolean

Include Greenhouse's built-in default rejection reasons alongside the organization's customized list. Defaults to false, in which case only reasons created by the organization are returned. Set to true to also surface the standard set (e.g. Not a cultural fit, Lacking skill(s)/qualification(s), Wasn't interested, Didn't like offer) that every Greenhouse account starts with.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
namestring

Display label shown to recruiters when rejecting a candidate (e.g. Not a cultural fit, Lacking skill(s)/qualification(s), Wasn't interested, Didn't like offer, Spam). Unique within the organization. Free-text, since each organization customizes its own list under Configure > Custom Options > Rejection Reasons. Reason categorization (hire/non-hire, we vs. they rejected) is conveyed by the nested type rather than by the name.