---
title: "Get Dependents"
method: POST
path: "/employer/plans-dependents"
tags: ["Benefits"]
---

# Get Dependents

`POST /employer/plans-dependents`

**Beta:** This endpoint is in beta and may change.
Read dependents by Finch ID. A maximum of 50 dependents can be requested at once.

## Query parameters

- `entity_ids` string[]

## Headers

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

## Request body

- object
  - `requests` object[], required
    - `dependent_id` string, required — The Finch ID of the dependent to read.
  - `options` object
    - `include` string[]

## Response `200`

Dependent data

- GetDependentsResponse
  - `responses` object[], required — The batch response array.
    - `dependent_id` string, required — The Finch ID of the dependent.
    - `code` integer, required — The HTTP status code of the response for this dependent.
    - `body` union, required
      - DependentResponse
        - `dependent_id` string, required — A stable Finch ID for the dependent.
        - `first_name` string, required — The dependent's first name.
        - `last_name` string, required — The dependent's last name.
        - `middle_name` string, nullable, required — The dependent's middle name.
        - `ssn` string, nullable, required — The dependent's Social Security Number.
        - `date_of_birth` string, nullable, required — The dependent's date of birth in ISO 8601 format (YYYY-MM-DD).
        - `gender` 'decline_to_specify' | 'female' | 'male' | 'other' | 'null', nullable, required — The dependent's gender.
        - `coverage` DependentCoverage[], required — The dependent's coverage, grouped by the individual covering them.
          - `individual_id` string, required — The Finch ID of the individual in the company covering this dependent.
          - `relationship_to_individual` 'child' | 'disabled_dependent' | 'domestic_partner' | 'foster_child' | 'other' | 'spouse' | 'stepchild' | 'ward', required — The dependent's relationship to the covering individual.
          - `enrollments` DependentEnrollment[], required — The enrollments this dependent is covered under via this individual.
            - `id` string, required — The Finch ID of the enrollment.
            - `type` 'commuter' | 'dental' | 'hsa' | 'fsa' | 'life_insurance' | 'long_term_disability' | 'medical' | 'other' | 'short_term_disability' | 'vision' | 'null', nullable, required — The plan type of the enrollment.
      - 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
- `400` — 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)