> ## 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 event

A benefit event is what opens an enrollment window — annual open enrollment for
a whole entity, or a new hire or qualifying life event (QLE) for a single
worker. It points at the [program](/reference/benefit-programs/object) the
window opens into, carries the event `date` (the point: hire date, QLE date, or
the open-enrollment effective date), and the `starts`/`ends` of the window
itself. An open-enrollment event fans out one enrollment per eligible worker; a
new-hire or QLE event opens one.

### Attributes

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

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

<ResponseField name="program" type="string">
  ID of the [program](/reference/benefit-programs/object) the window opens into.
</ResponseField>

<ResponseField name="entity" type="string | null">
  ID of the entity, set for an entity-wide open enrollment. Null for a
  worker-specific event.
</ResponseField>

<ResponseField name="worker" type="string | null">
  ID of the worker, set for a new-hire or QLE event. Null for an entity-wide
  event.
</ResponseField>

<ResponseField name="type" type="string">
  What opened the window. One of `open_enrollment`, `new_hire`, `qle`, or
  `termination`.
</ResponseField>

<ResponseField name="subtype" type="string | null">
  For a `qle`, the qualifying reason — e.g. `marriage`, `newborn`, `divorce`,
  `adoption`, `lost_coverage`. Null for other types.
</ResponseField>

<ResponseField name="date" type="string">
  The event point — the hire or QLE date, or the open-enrollment effective date.
</ResponseField>

<ResponseField name="starts" type="string | null">
  First day the enrollment window is open.
</ResponseField>

<ResponseField name="ends" type="string | null">
  Last day the enrollment window is open.
</ResponseField>

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

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

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