---
title: "List ledger entries"
description: "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."
canonical: https://docs.rumoro.dev/api/billing/list-ledger
markdown: https://docs.rumoro.dev/api/billing/list-ledger.mdx
---

# List ledger entries

`GET /v1/billing/ledger`

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.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `cursor` | query | The `nextCursor` of the previous page. Do not parse it. |
| `limit` | query | How many to return, from 1 to 100, 25 by default. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Ledger entries, latest first |
| 400 | The cursor is not valid |
| 401 | The credential is missing or not valid |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).