Benefit enrollment

A benefit enrollment is one worker’s run through an event — the workflow that tracks their progress from “not started” through “submitted” and produces their elections. It’s the container: the elections are the choices it yields. There is one enrollment per worker per event.

Lifecycle

An enrollment moves through these statuses:

Status	Meaning
`not_started`	The window is open for the worker; no choices made yet.
`in_progress`	The worker has begun making choices.
`submitted`	The worker has submitted their choices; coverage is finalized.
`completed`	The run is complete — a decision exists for every eligible plan.
`waived`	The worker declined coverage entirely.
`cancelled`	The run was cancelled.

Attributes

string

Unique identifier for the enrollment, e.g. bene_X8pR5sT1vA4o.

string

The object type. Always benefit.enrollment.

string

ID of the worker whose run this is.

string

ID of the event the run is under.

string

Workflow status — see the lifecycle table above.

object

Set of key-value pairs attached to the enrollment.

string

Timestamp of when the enrollment was created.

string

Timestamp of when the enrollment was last updated.

Update a benefit event

Create a benefit enrollment

⌘I

Working with the API

Core Resources

HR

Workforce

Benefits

Payments

Payroll

Documents

Time

Labor

Legal

Lifecycle

Attributes

​Lifecycle

​Attributes

Lifecycle

Attributes