v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0755143347.0 KB
Benefits

List 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.

get/employer/plans

Query parameters

entity_idsstring[]

The entity IDs to specify which entities' data to access. Provide exactly one entity ID per request; a maximum of one is accepted.

[
  "550e8400-e29b-41d4-a716-446655440000"
]
plan_typestring
Example:medical

Filter plans by type (e.g. medical, dental, vision). Case-insensitive. See PlanType for known values.

limitinteger

Number of items to return (defaults to 50, maximum 50)

offsetinteger

Index to start from (defaults to 0)

Headers

Finch-API-Versionstring date required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Response

Benefit plan data