GRgreenhouse
EEOC

List EEOC

EEOC responses capture a candidate's voluntary self-identification of race, gender, veteran status, and disability status, collected via the federally-approved Equal Employment Opportunity Commission questionnaire. Each row belongs to a single application and is keyed by application_id; a candidate who applies to multiple jobs may have multiple responses. Categories are a fixed enum set by the regulator and cannot be customized — for org-defined demographic questions, use /v3/demographic_questions instead. Sensitive PII: unlike the in-app EEOC report (which only exposes aggregated, anonymized counts), this endpoint returns row-level responses tied to a specific candidate and application. Access is gated on the harvest:eeoc:list scope and partner permissions are typically restricted accordingly.

get/v3/eeoc

Request

  • Base URL
    https://harvest.greenhouse.io
  • URL
    https://harvest.greenhouse.io/v3/eeoc
  • Auth
    • OAuth 2
      Authorization code: https://auth.greenhouse.io/authorize
      Client credentials
      Token URL: https://auth.greenhouse.io/token scopes: harvest:eeoc: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
application_idsinteger[]

Comma separated list

fieldsstring[]

Comma separated list of fields to return

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

Filter by the timestamp the candidate submitted the EEOC questionnaire. Pass any combination of gte, lte, gt, lt as ISO 8601 date-times. Responses where the candidate has not yet submitted are excluded by this filter.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
application_idinteger

Id of the application this EEOC response is attached to. Each application has at most one EEOC response.

candidate_idinteger

Id of the candidate (person) who submitted this response — the application's owner.

submitted_atstring date-time nullable

Timestamp the candidate submitted the EEOC questionnaire, in ISO 8601. null while the questionnaire has been requested but not yet responded to.

Changes

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