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

> Leave transactions are ledger entries that explain every change to a leave balance

Use leave transactions when you need the audit trail behind a leave balance.

### Attributes

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

<ResponseField name="balance" type="string">
  ID of the leave balance this transaction belongs to.
</ResponseField>

<ResponseField name="entitlement" type="string | null">
  ID of the entitlement that produced this transaction. Returns `null` for manual adjustments or
  transactions not tied to a specific entitlement.
</ResponseField>

<ResponseField name="type" type="string">
  Transaction type. One of `accrual`, `usage`, `reversal`, `adjustment`, `carryover`, `expiry`,
  `forfeit`, or `payout`.
</ResponseField>

<ResponseField name="status" type="string">
  Transaction status. `posted` means the entry is final. `pending` means the entry is expected for
  a future date and may still change before it is posted.
</ResponseField>

<ResponseField name="amount" type="number">
  Signed balance change for the transaction. Credits are positive and debits are negative.
</ResponseField>

<ResponseField name="date" type="string">
  ISO 8601 effective date of the transaction.
</ResponseField>

<ResponseField name="description" type="string | null">
  Optional freeform description for the transaction.
</ResponseField>

<ResponseField name="leave" type="string | null">
  Leave ID linked to the transaction. Returns `null` unless the transaction is tied to leave usage
  or a reversal.
</ResponseField>

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

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

<ResponseExample>
  ```json Leave Transaction theme={null}
  {
    "id": "lvtx_7mNpK4wYz3qRsF",
    "balance": "lvb_8kPqR2nYx1mVtD",
    "entitlement": "lve_3vNqM7xRk2pWsT",
    "type": "accrual",
    "status": "posted",
    "amount": "2.08",
    "date": "2026-03-01",
    "description": "Policy accrual",
    "leave": null,
    "created": "2026-03-01T00:00:00Z",
    "updated": "2026-03-01T00:00:00Z"
  }
  ```
</ResponseExample>