---
title: "List ledger entries"
method: GET
path: "/v1/billing/ledger"
tags: ["Billing"]
---

# List ledger entries

`GET /v1/billing/ledger`

## Request

- Base URL: `https://api.rumoro.dev`
- URL: `https://api.rumoro.dev/v1/billing/ledger`
- Auth: HTTP bearer

Shows the balance's history, latest first. Entries cover the welcome credit, top-ups, refunds, adjustments, and the daily keyword-day and mention debits. Debits carry their UTC settlement day and cumulative units. Cursor pages.

## Query parameters

- `cursor` string: The `nextCursor` of the previous page. Do not parse it.
- `limit` integer: How many to return, from 1 to 100, 25 by default.

## Response `200`

Ledger entries, latest first

- LedgerList
  - `data` object[], required: Ledger entries, latest first.
    - `id` string, required: The ledger entry's id (led_...).
    - `kind` 'signup_credit' | 'topup' | 'refund' | 'debit_keyword_days' | 'debit_mentions' | 'debit_comments' | 'adjustment', required: Type of ledger entry.
    - `amountCents` integer, required: Whole US cents. Credits are positive and debits negative.
    - `day` string, nullable, required: For debits, the last UTC day this entry settles (YYYY-MM-DD).
    - `units` integer, nullable, required: For debits, the running total of mentions or keyword-days settled up to and including this entry.
    - `note` string, nullable, required: Note attached to a credit or adjustment.
    - `polarOrderId` string, nullable, required: Polar order of a top-up or refund. Null otherwise.
    - `createdAt` string, required: UTC time in ISO 8601.
  - `nextCursor` string, nullable, required: Cursor for the next page, or null when there are no more pages.

## Other responses

- `400`: The cursor is not valid
- `401`: The credential is missing or not valid

---

[API](https://skmtc.dev/rumoro/apis/rumoro-api.md) · [All operations](https://skmtc.dev/rumoro/apis/rumoro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rumoro/apis/rumoro-api/revisions/9ef63ea894d1?raw)