---
title: "List Dependents"
method: GET
path: "/employer/plans-dependents"
tags: ["Benefits"]
---

# List Dependents

`GET /employer/plans-dependents`

**Beta:** This endpoint is in beta and may change.
Read the dependents covered under the benefit plans of the company, including their coverage and enrollments.

## Query parameters

- `entity_ids` string[]
- `limit` integer
- `offset` integer
- `include` string[]

## Headers

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

## Response `200`

Dependent data

- GetAllDependentsResponse
  - `paging` Paging, required
    - `count` integer — The total number of elements for the entire query (not just the given page)
    - `offset` integer, required — The current start index of the returned list of elements
  - `dependents` DependentResponse[], required — The array of dependents.
    - `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.

## 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)