---
title: "List EEOC"
method: GET
path: "/v3/eeoc"
tags: ["EEOC"]
---

# List EEOC

`GET /v3/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.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `application_ids` integer[]
- `fields` string[]
- `submitted_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `application_id` integer — Id of the application this EEOC response is attached to. Each application has at most one EEOC response.
  - `candidate_id` integer — Id of the candidate (person) who submitted this response — the application's owner.
  - `gender` object — Self-identified gender. `id` and `description` are `null` when the candidate skipped the question. The fixed enum values for `description` are `Male`, `Female`, and `Decline To Self Identify`.
    - `id` integer, nullable
    - `description` string, nullable
  - `race` object — Self-identified race or ethnicity. `id` and `description` are `null` when the candidate skipped the question. The fixed enum values for `description` are `American Indian or Alaskan Native`, `Asian`, `Black or African American`, `Hispanic or Latino`, `White`, `Native Hawaiian or Other Pacific Islander`, `Two or More Races`, and `Decline To Self Identify`.
    - `id` integer, nullable
    - `description` string, nullable
  - `veteran_status` object — Self-identified protected-veteran status under VEVRAA. `id` and `description` are `null` when the candidate skipped the question. The fixed enum values for `description` are `I am not a protected veteran`, `I identify as one or more of the classifications of a protected veteran`, and `I don't wish to answer`.
    - `id` integer, nullable
    - `description` string, nullable
  - `disability_status` object — Self-identified disability status under Section 503. `id` and `description` are `null` when the candidate skipped the question. The fixed enum values for `description` are `Yes, I have a disability, or have had one in the past`, `No, I do not have a disability and have not had one in the past`, and `I do not want to answer`.
    - `id` integer, nullable
    - `description` string, nullable
  - `submitted_at` string, 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.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)