---
title: "Get Eeocs"
method: GET
path: "/api/ats/v1/eeocs"
tags: ["EEOC"]
---

# Get Eeocs

`GET /api/ats/v1/eeocs`

Returns a list of EEOC records.

## Query parameters

- `ids` string, nullable — The ID of the eeocs to fetch
- `candidate` string, nullable — The candidates id for the eeocs to fetch
- `include_raw_data` boolean — Include raw data in the response
- `include_custom_fields` boolean — Whether to include custom fields in the response.
- `page_size` integer — Number of results to return per page. Maximum size is 200.
- `cursor` string — The pagination cursor value.
- `modified_after` string — If provided, only objects synced by Bindbee after this date time will be returned. Format: DateTime (ISO 8601)
- `expand` string — Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces. You can also specify required fields in [] for each relation name.

## Headers

- `x-connector-token` string, required

## Response `200`

Successful Response

- PaginatedResponseAtsEEOC
  - `cursor` string, nullable, required — Cursor value to fetch next set of items
  - `page_size` integer, required — Indicates the count of items in the response
  - `items` AtsEEOC[], required — List of items in the current response
    - `id` string, uuid, required
    - `remote_id` string, nullable, required — The third-party API ID of the matching object.
    - `modified_at` string, required — This is the datetime that this object was last updated by Bindbee
    - `raw_data` object, nullable — This is the Raw data
    - `custom_fields` object, nullable, required — The custom fields related to the model
    - `candidate` string, nullable, required — The candidate associated with the EEOC data.
    - `submitted_at` string, nullable, required — The ISO date string when the EEOC data was submitted.
    - `race` 'AMERICAN_INDIAN_OR_ALASKA_NATIVE' | 'ASIAN_OR_INDIAN_SUBCONTINENT' | 'BLACK_OR_AFRICAN_AMERICAN' | 'HISPANIC_OR_LATINO' | 'NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER' | 'TWO_OR_MORE_RACES' | 'WHITE' | 'PREFER_NOT_TO_DISCLOSE' | '-', nullable, required — The race of the candidate as indicated in the EEOC form. If the value is not one of the defined enum values, the original value passed through will be returned.
    - `gender` 'MALE' | 'FEMALE' | 'NON-BINARY' | 'OTHER' | 'PREFER_NOT_TO_DISCLOSE' | '-', nullable, required — The gender of the candidate as indicated in the EEOC form. If the value is not one of the defined enum values, the original value passed through will be returned.
    - `veteran_status` 'I_DONT_WISH_TO_ANSWER' | 'DISABLED_VETERAN' | 'SPECIAL_DISABLED_VETERAN' | 'VIETNAM_ERA_VETERAN' | 'OTHER_PROTECTED_VETERAN' | 'THREE_YEAR_RECENTLY_SEPARATED_VETERAN' | 'ONE_YEAR_RECENTLY_SEPARATED_VETERAN' | 'DISABLED_INDIVIDUAL' | 'I_IDENTIFY_AS_ONE_OR_MORE_OF_THE_CLASSIFICATIONS_OF_A_PROTECTED_VETERAN' | 'I_AM_NOT_A_PROTECTED_VETERAN' | '-', nullable, required — The veteran status of the candidate as indicated in the EEOC form. If the value is not one of the defined enum values, the original value passed through will be returned.
    - `disability_status` 'YES_I_HAVE_A_DISABILITY_OR_PREVIOUSLY_HAD_A_DISABILITY' | 'NO_I_DONT_HAVE_A_DISABILITY' | 'I_DONT_WISH_TO_ANSWER' | '-', nullable, required — The disability status of the candidate as indicated in the EEOC form. If the value is not one of the defined enum values, the original value passed through will be returned.

## Other responses

- `401` — Missing or invalid bearer authentication credentials.
- `403` — The credentials are valid but do not permit access to this resource, e.g. a connector token used on a different API category or a model whose writes are disabled.
- `422` — Validation Error
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/bindbee/apis/bindbee-apis.md) · [All operations](https://skmtc.net/bindbee/apis/bindbee-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bindbee/bindbee-apis/revisions/7da10dc93a21/schema)