Skip to main content
A benefit election is a worker’s choice to enroll in a specific plan — the coverage they hold. An election is the durable record of “this worker is covered by this plan”; it is created when the worker enrolls and terminated when the coverage ends. To change a plan, terminate the existing election and create a new one rather than editing in place.

Attributes

string
Unique identifier for the election, e.g. bele_W7oQ4rS0uZ3n.
string
The object type. Always benefit.election.
string
ID of the worker holding the coverage.
string
ID of the elected plan.
string | null
ID of the enrollment run that produced this election, if any. Null for an election created directly.
string
The coverage tier in effect, e.g. employee_only or family. Derived from the covered dependents — family when any are covered, otherwise employee_only.
array
IDs of the worker dependents this election covers.
string
Election status. One of active, waived, or terminated.
object
Employer and worker cost split for this election, materialized from the plan’s contribution policy at the time of enrollment.
string | null
First day the coverage is in effect.
string | null
Last day the coverage is in effect. Null while active.
object
Set of key-value pairs attached to the election.
string
Timestamp of when the election was created.
string
Timestamp of when the election was last updated.