---
title: "Get Enrollments"
method: POST
path: "/employer/plans-enrollments"
tags: ["Benefits"]
---

# Get Enrollments

`POST /employer/plans-enrollments`

**Beta:** This endpoint is in beta and may change.
Read enrollments by Finch ID. A maximum of 50 enrollments 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
    - `enrollment_id` string, required — The Finch ID of the enrollment to read.

## Response `200`

Enrollment data

- GetEnrollmentsResponse
  - `responses` object[], required — The batch response array.
    - `enrollment_id` string, required — The Finch ID of the enrollment.
    - `code` integer, required — The HTTP status code of the response for this enrollment.
    - `body` union, required
      - EnrollmentResponse
        - `id` string, required — A stable Finch ID for the enrollment.
        - `individual_id` string, required — The Finch ID of the individual enrolled in the plan.
        - `plan_id` string, required — The Finch ID of the benefit plan.
        - `coverage_tier` string, nullable, required — The coverage tier of the enrollment. Known values: `employee_only`, `employee_spouse`, `employee_children`, `employee_family`. Provider-specific values outside this list may also be returned.
        - `coverage_start_date` string, nullable, required — The start date of coverage in ISO 8601 format (YYYY-MM-DD).
        - `coverage_end_date` string, nullable, required — The end date of coverage in ISO 8601 format (YYYY-MM-DD).
        - `contributions` EnrollmentContributions, nullable, required — The contribution details for the enrollment.
          - `frequency` string, required — The frequency of the contribution. Known values: `per_pay_period`, `weekly`, `bi_weekly`, `semi_monthly`, `monthly`, `quarterly`, `annually`. Provider-specific values outside this list may also be returned.
          - `employee_contribution` ContributionAmount, nullable, required — The employee's contribution amount.
            - `amount` number, nullable, required — The contribution amount in cents.
            - `currency` string, nullable, required — The currency of the contribution amount (e.g. usd).
          - `employer_contribution` object, nullable, required — The employer's contribution amount.
            - `amount` number, nullable, required — The contribution amount in cents.
            - `currency` string, nullable, required — The currency of the contribution amount (e.g. usd).
        - `dependent_ids` string[], nullable, required — The Finch IDs of dependents covered under this enrollment.
        - `status` string, nullable, required — The status of the enrollment. Known values: `active`, `inactive`. Provider-specific values outside this list may also be returned.
      - 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)