> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Benefit plan

A benefit plan is a specific offering within a [program](/reference/benefit-programs/object) —
one carrier's plan, with its eligibility, offered coverage tiers, and employer
contribution. Each metal level (e.g. Gold, Silver) is its own plan.

### Attributes

<ResponseField name="id" type="string">
  Unique identifier for the plan, e.g. `benpl_V6nP3qR9tY2m`.
</ResponseField>

<ResponseField name="object" type="string">
  The object type. Always `benefit.plan`.
</ResponseField>

<ResponseField name="program" type="string">
  ID of the program the plan belongs to.
</ResponseField>

<ResponseField name="provider" type="string">
  ID of the carrier (benefit provider).
</ResponseField>

<ResponseField name="entity" type="string">
  ID of the entity (employer) — inherited from the program.
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable plan name.
</ResponseField>

<ResponseField name="type" type="string">
  Benefit category. One of `medical`, `dental`, `vision`, `life`, `disability`,
  `retirement`, or `other`.
</ResponseField>

<ResponseField name="country" type="string | null">
  ISO-3166 country the plan is offered in. Null means global.
</ResponseField>

<ResponseField name="network" type="string | null">
  Network name or type (e.g. `ppo`, `hmo`) when applicable.
</ResponseField>

<ResponseField name="status" type="string">
  Plan status. One of `draft`, `active`, or `inactive`.
</ResponseField>

<ResponseField name="coverages" type="array">
  Coverage tiers the plan offers (e.g. `employee_only`, `family`). Offering a
  tier above `employee_only` is what makes dependents eligible.
</ResponseField>

<ResponseField name="eligibility" type="string | null">
  CEL expression deciding which workers may elect this plan, evaluated against
  the worker shape. Null means anyone eligible for the program may elect it.
</ResponseField>

<ResponseField name="contribution" type="object">
  Employer cost-sharing policy, by coverage tier.
</ResponseField>

<ResponseField name="terms" type="object">
  Display summary of plan terms (deductible, out-of-pocket max, premium).
</ResponseField>

<ResponseField name="resources" type="object">
  Plan materials — links and document references.
</ResponseField>

<ResponseField name="starts" type="string | null">
  First day the plan is in effect.
</ResponseField>

<ResponseField name="ends" type="string | null">
  Last day the plan is in effect. Null means ongoing.
</ResponseField>

<ResponseField name="metadata" type="object">
  Set of key-value pairs attached to the plan.
</ResponseField>

<ResponseField name="created" type="string">
  Timestamp of when the plan was created.
</ResponseField>

<ResponseField name="updated" type="string">
  Timestamp of when the plan was last updated.
</ResponseField>