---
title: "Individual"
method: POST
path: "/employer/individual"
tags: ["Organization"]
---

# Individual

`POST /employer/individual`

Read individual data, excluding income and employment data

## Query parameters

- `entity_ids` string[]

## Headers

- `Finch-API-Version` string, date, required
- `Content-Type` string, required

## Request body

- object
  - `requests` object[], required — The array of batch requests. Maximum 10000 items per request.
    - `individual_id` string, required
  - `options` object, nullable
    - `include` string[]

## Response `200`

Individual data

- GetIndividualsResponse
  - `responses` object[], required
    - `individual_id` string, required
    - `code` integer, required
    - `body` union, required
      - object
        - `first_name` string, nullable, required — The legal first name of the individual.
        - `middle_name` string, nullable, required — The legal middle name of the individual.
        - `last_name` string, nullable, required — The legal last name of the individual.
        - `preferred_name` string, nullable, required — The preferred name of the individual.
        - `emails` object[], nullable
          - `data` string, required
          - `type` 'work' | 'personal' | 'null', nullable, required
        - `phone_numbers` object[], nullable, required
          - `data` string, nullable, required
          - `type` 'work' | 'personal' | 'null', nullable, required
        - `gender` 'female' | 'male' | 'other' | 'decline_to_specify' | 'null', nullable, required — The gender of the individual.
        - `ethnicity` 'asian' | 'white' | 'black_or_african_american' | 'native_hawaiian_or_pacific_islander' | 'american_indian_or_alaska_native' | 'hispanic_or_latino' | 'two_or_more_races' | 'decline_to_specify' | 'null', nullable, required — The EEOC-defined ethnicity of the individual.
        - `marital_status` 'single' | 'married' | 'divorced' | 'widowed' | 'domestic_partner' | 'unknown' | 'null', nullable, required — The employee's marital status, used for beneficiary designation and spousal consent workflows.
        - `dob` string, nullable, required
        - `ssn` string, nullable — Social Security Number of the individual. This field is only available with the `ssn` scope enabled and the `options: { include: ['ssn'] }` param set in the body. [Click here to learn more about enabling the SSN field](/developer-resources/Enable-SSN-Field).
        - `encrypted_ssn` string, nullable — Social Security Number of the individual in **encrypted** format. This field is only available with the `ssn` scope enabled and the `options: { include: ['ssn'] }` param set in the body.
        - `residence` Location, nullable, required
          - `line1` string, nullable, required — Street address or PO box.
          - `line2` string, nullable, required — Apartment, suite, unit, or building.
          - `city` string, nullable, required — City, district, suburb, town, or village.
          - `state` string, nullable, required — The state code.
          - `postal_code` string, nullable, required — The postal code or zip code.
          - `country` string, nullable, required — The 2-letter ISO 3166 country code.
          - `name` string, nullable
          - `source_id` string, nullable
        - `id` string, uuid, required — A stable Finch `id` (UUID v4) for an individual in the company.
      - BatchError
        - `code` number, required
        - `finch_code` string
        - `message` string, required
        - `name` string, required

## Other responses

- `202` — The request has been accepted for processing, but data is not yet available
- `422` — The request could not be processed due to a validation error

---

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