> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lavendly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get ledger

> Credit balance, plan, pending reservations, recent transactions.

<ResponseExample>
  ```json 200 theme={null}
  {
    "user_id": "user_abc123",
    "plan":    "creator",
    "plan_pool": 1000,
    "plan_resets_at": 1736208000000,
    "balance":  742,
    "pending":  18,
    "available": 724,
    "transactions": [
      { "ts": 1733991122000, "kind": "commit",  "amount": -10, "label": "video / 5s" },
      { "ts": 1733991100000, "kind": "reserve", "amount":  10, "token": "rsv_..." }
    ]
  }
  ```
</ResponseExample>

| Field            | Meaning                                                    |
| ---------------- | ---------------------------------------------------------- |
| `balance`        | Confirmed credits remaining.                               |
| `pending`        | Sum of outstanding reserves.                               |
| `available`      | `balance - pending`, what you can spend right now.         |
| `plan_pool`      | Monthly allocation for the active plan.                    |
| `plan_resets_at` | When the monthly pool refills. Unspent credits carry over. |