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

# Individual

`POST /employer/individual`

Read individual data, excluding income and employment data

## Headers

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

## Request body

- object
  - `requests` object[]
    - `individual_id` string
  - `options` object, nullable
    - `include` string[]

## Response `200`

Individual data

- GetIndividualsResponse
  - `responses` object[], required
    - `individual_id` string
    - `code` integer
    - `body` object
      - `id` string — A stable Finch `id` (UUID v4) for an individual in the company.
      - `first_name` string, nullable — The legal first name of the individual.
      - `middle_name` string, nullable — The legal middle name of the individual.
      - `last_name` string, nullable — The legal last name of the individual.
      - `preferred_name` string, nullable — The preferred name of the individual.
      - `emails` object[], nullable
        - `data` string
        - `type` string
      - `phone_numbers` object[], nullable
        - `data` string, nullable
        - `type` 'work' | 'personal' | 'null', nullable
      - `gender` 'female' | 'male' | 'other' | 'decline_to_specify' | 'null', nullable — 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 — The EEOC-defined ethnicity of the individual.
      - `dob` string, nullable
      - `residence` Location, nullable
        - `line1` string, nullable — Street address or PO box.
        - `line2` string, nullable — Apartment, suite, unit, or building.
        - `city` string, nullable — City, district, suburb, town, or village.
        - `state` string, nullable — The state code.
        - `postal_code` string, nullable — The postal code or zip code.
        - `country` string, nullable — The 2-letter ISO 3166 country code.
        - `name` string, nullable
        - `source_id` string, nullable
      - `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.

---

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