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

# List Plans

`GET /employer/plans`

**Beta:** This endpoint is in beta and may change.
Read the benefit plans offered by the company, including carrier, coverage tiers, and deduction codes.

## Query parameters

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

## Headers

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

## Response `200`

Benefit plan data

- GetAllPlansResponse
  - `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
  - `plans` PlanResponse[], required — The array of benefit plans.
    - `id` string, required — A stable Finch ID for the benefit plan.
    - `name` string, required — The name of the benefit plan.
    - `type` 'commuter' | 'dental' | 'hsa' | 'fsa' | 'life_insurance' | 'long_term_disability' | 'medical' | 'other' | 'short_term_disability' | 'vision' | 'null', nullable, required — The type of the benefit plan.
    - `description` string, nullable, required — A description of the benefit plan.
    - `network_type` 'epo' | 'hdhp' | 'hmo' | 'other' | 'pos' | 'ppo' | 'null', nullable, required — The network type of the benefit plan.
    - `carrier` PlanCarrier, nullable, required — The insurance carrier associated with the benefit plan.
      - `id` string, nullable, required — The unique identifier of the insurance carrier.
      - `name` string, nullable, required — The name of the insurance carrier.
    - `start_date` string, required — The start date of the benefit plan in ISO 8601 format (YYYY-MM-DD).
    - `end_date` string, nullable, required — The end date of the benefit plan in ISO 8601 format (YYYY-MM-DD).
    - `coverage_tiers` PlanCoverageTier[], nullable, required — The available coverage tiers for the benefit plan. Known values: `employee_only`, `employee_spouse`, `employee_children`, `employee_family`. Provider-specific values outside this list may also be returned.
    - `deduction_codes` string[], nullable, required — The deduction codes associated with the benefit plan.

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