---
title: "List ledger entries"
description: "Every movement of the balance, newest first: the welcome credit, top-ups, refunds, the daily keyword-day and mention debits, adjustments. A debit row carries the UTC day it settled and the cumulative units behind it. Cursor paged."
canonical: https://docs.mentio.dev/api/billing/list-ledger
markdown: https://docs.mentio.dev/api/billing/list-ledger.mdx
---

# List ledger entries

`GET /v1/billing/ledger`

Every movement of the balance, newest first: the welcome credit, top-ups, refunds, the daily keyword-day and mention debits, adjustments. A debit row carries the UTC day it settled and the cumulative units behind it. Cursor paged.

## Parameters

- `cursor` (query): Opaque cursor from a previous page (`nextCursor`).
- `limit` (query): Page size, 1 to 100 (default 25).

## Responses

- 200: Ledger entries, newest first
- 400: Invalid cursor
- 401: Missing or invalid credentials

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx