Skip to main content
GET
/
v1
/
ledger
Get ledger
curl --request GET \
  --url https://api.example.com/v1/ledger
{
  "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_..." }
  ]
}

{
  "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_..." }
  ]
}
FieldMeaning
balanceConfirmed credits remaining.
pendingSum of outstanding reserves.
availablebalance - pending, what you can spend right now.
plan_poolMonthly allocation for the active plan.
plan_resets_atWhen the monthly pool refills. Unspent credits carry over.