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

# List ledger entries

`GET /v1/billing/ledger`

## Request

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

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.

## Query parameters

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

## Response `200`

Ledger entries, newest first

- LedgerList
  - `data` object[], required: Ledger entries, newest first.
    - `id` string, required: Ledger entry id (led_...).
    - `kind` 'signup_credit' | 'topup' | 'refund' | 'debit_keyword_days' | 'debit_mentions' | 'debit_comments' | 'adjustment', required: signup_credit, topup, refund, debit_keyword_days, debit_mentions, debit_comments or adjustment.
    - `amountCents` integer, required: Integer USD cents; credits positive, debits negative.
    - `day` string, nullable, required: Debit rows: the last UTC day the row settled (YYYY-MM-DD).
    - `units` integer, nullable, required: Debit rows: cumulative units (mentions or keyword-days) settled up to this row.
    - `note` string, nullable, required: Free text on credits and adjustments.
    - `polarOrderId` string, nullable, required: Top-ups and refunds: the Polar order.
    - `createdAt` string, required: ISO 8601 timestamp, UTC.
  - `nextCursor` string, nullable, required: Pass it back as `cursor` for the next page; null on the last.

## Other responses

- `400`: Invalid cursor
- `401`: Missing or invalid credentials

---

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