> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bindbee.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Eeoc By Id

> Returns an EEOC record with the given id.



## OpenAPI

````yaml get /api/ats/v1/eeocs/{id}
openapi: 3.1.0
info:
  title: Bindbee APIs
  version: 0.1.0
servers:
  - url: https://api.bindbee.dev
  - url: https://api-eu.bindbee.dev
security: []
paths:
  /api/ats/v1/eeocs/{id}:
    get:
      tags:
        - EEOC
      summary: Get Eeoc By Id
      description: Returns an EEOC record with the given id.
      operationId: get_eeoc_by_id_api_ats_v1_eeocs__id__get
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Id
        - name: include_raw_data
          in: query
          required: false
          schema:
            type: boolean
            description: Include raw data in the response
            examples:
              - false
            default: false
            title: Include Raw Data
          description: Include raw data in the response
        - name: include_custom_fields
          in: query
          required: false
          schema:
            type: boolean
            description: Whether to include custom fields in the response.
            examples:
              - false
            default: false
            title: Include Custom Fields
          description: Whether to include custom fields in the response.
        - name: expand
          in: query
          required: false
          schema:
            type: string
            description: >-
              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.
            examples:
              - manager[first_name,last_name]
            title: Expand
          description: >-
            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.
        - name: x-connector-token
          in: header
          required: true
          schema:
            type: string
            title: X-Connector-Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AtsEEOC'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    AtsEEOC:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          examples:
            - 018b18ef-c487-703c-afd9-0ca478ccd9d6
        remote_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Remote Id
          description: The third-party API ID of the matching object.
          examples:
            - '123321'
        modified_at:
          type: string
          title: Modified At
          description: This is the datetime that this object was last updated by Bindbee
          examples:
            - '2021-10-16T00:00:00Z'
        raw_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Raw Data
          description: This is the Raw data
          examples:
            - key_1: Platform dependent data 1
              key_2: Platform dependent data 2
        custom_fields:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Custom Fields
          description: The custom fields related to the model
          examples:
            - category_group: REG
              disability_type: ASBERG
              hire_date: '1991-03-16T00:00:00'
              hire_source: REFER
              nationality: USA
              original_hire_date: '1991-03-16T00:00:00'
        candidate:
          anyOf:
            - {}
            - type: 'null'
          title: Candidate
          description: The candidate associated with the EEOC data.
          examples:
            - 018b4bfb-5ece-70b1-ad5e-862a9433aa65
        submitted_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Submitted At
          description: The ISO date string when the EEOC data was submitted.
          examples:
            - '2021-01-01T00:00:00Z'
        race:
          anyOf:
            - type: string
            - type: 'null'
          enum:
            - 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
            - '-'
          title: Race
          description: >-
            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.
          examples:
            - WHITE
        gender:
          anyOf:
            - type: string
            - type: 'null'
          enum:
            - MALE
            - FEMALE
            - NON-BINARY
            - OTHER
            - PREFER_NOT_TO_DISCLOSE
            - '-'
          title: Gender
          description: >-
            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.
          examples:
            - MALE
        veteran_status:
          anyOf:
            - type: string
            - type: 'null'
          enum:
            - 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
            - '-'
          title: Veteran Status
          description: >-
            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.
          examples:
            - DISABLED_VETERAN
        disability_status:
          anyOf:
            - type: string
            - type: 'null'
          enum:
            - YES_I_HAVE_A_DISABILITY_OR_PREVIOUSLY_HAD_A_DISABILITY
            - NO_I_DONT_HAVE_A_DISABILITY
            - I_DONT_WISH_TO_ANSWER
            - '-'
          title: Disability Status
          description: >-
            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.
          examples:
            - YES_I_HAVE_A_DISABILITY_OR_PREVIOUSLY_HAD_A_DISABILITY
      type: object
      required:
        - id
        - remote_id
        - modified_at
        - custom_fields
        - candidate
        - submitted_at
        - race
        - gender
        - veteran_status
        - disability_status
      title: AtsEEOC
      description: >-
        The AtsEEOC object represents the Equal Employment Opportunity
        Commission (EEOC) related data for a candidate within the ATS.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````