---
title: "Get Plan"
method: GET
path: "/employer/plans/{plan_id}"
tags: ["Benefits"]
---

# Get Plan

`GET /employer/plans/{plan_id}`

**Beta:** This endpoint is in beta and may change.
Read a single benefit plan by its Finch ID.

## Path parameters

- `plan_id` string, required

## Query parameters

- `entity_ids` string[]

## Headers

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

## Response `200`

Benefit plan data

- GetPlanResponse
  - `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
- `404` — The requested plan does not exist

---

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