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

# Leave Entitlement

> Leave entitlements bind a leave policy to a worker, with optional per-worker overrides

Use leave entitlements when you need to see which leave policies currently apply to a worker and
when each policy started or ended.

### Attributes

<ResponseField name="id" type="string">
  Unique identifier for the leave entitlement, for example `lve_3vNqM7xRk2pWsT`.
</ResponseField>

<ResponseField name="worker" type="string">
  ID of the worker this entitlement belongs to.
</ResponseField>

<ResponseField name="policy" type="string">
  ID of the leave policy applied by this entitlement.
</ResponseField>

<ResponseField name="source" type="string">
  How the entitlement was created. One of `automatic` or `manual`.
</ResponseField>

<ResponseField name="overrides" type="object">
  Sparse policy overrides for this worker. Returns an empty object when no fields are overridden.
</ResponseField>

<ResponseField name="starts" type="string">
  ISO 8601 date when the entitlement starts.
</ResponseField>

<ResponseField name="ends" type="string | null">
  ISO 8601 date when the entitlement ends. Returns `null` for open-ended entitlements.
</ResponseField>

<ResponseField name="created" type="string">
  ISO 8601 timestamp of when the entitlement was created.
</ResponseField>

<ResponseField name="updated" type="string">
  ISO 8601 timestamp of the most recent update to the entitlement.
</ResponseField>

<ResponseExample>
  ```json Leave Entitlement theme={null}
  {
    "id": "lve_3vNqM7xRk2pWsT",
    "worker": "wr_CgcLakmx4guire",
    "policy": "lvp_Xk9mPq2vR8tn3e",
    "source": "manual",
    "overrides": {},
    "starts": "2026-01-01",
    "ends": null,
    "created": "2026-01-01T00:00:00Z",
    "updated": "2026-01-01T00:00:00Z"
  }
  ```
</ResponseExample>