Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
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

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.