---
title: "Read recent credit movements (top-ups, calls, SMS, number fees, refunds); no cursor, most recent first"
method: GET
path: "/v1/credit/ledger"
---

# Read recent credit movements (top-ups, calls, SMS, number fees, refunds); no cursor, most recent first

`GET /v1/credit/ledger`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/credit/ledger`
- Auth: HTTP bearer

Credit movement history, most recent first, WITHOUT a cursor (just `limit`, 1-200, default 50). Every entry's `description` is an English description COMPOSED from `type` - the stored Czech note never goes out.

## Query parameters

- `limit` integer

## Response `200`

Credit ledger entries

- object
  - `ledger` object[], required
    - `id` string, required
    - `ts` number, required
    - `type` 'bonus' | 'topup' | 'call_out' | 'call_in' | 'sms' | 'number_fee' | 'agent' | 'refund' | 'admin' | 'setup_revision' | 'subscription_grant' | 'subscription_expire', required
    - `amountHal` number, required
    - `grossHal` number, nullable, required
    - `description` string, required
    - `fromSubscriptionHal` number: Only on a charge covered by the monthly plan credit: the part of the charge the monthly credit paid, in hellers. Other entries do not have the field.

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).
- `503`: Error codes: ledger_unavailable (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)