---
title: "List the account's payment history"
method: GET
path: "/credits/tenants/me/topups"
tags: ["Top-ups"]
---

# List the account's payment history

`GET /credits/tenants/me/topups`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/tenants/me/topups`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns only TOPUP ledger entries for the account's pooled balance, newest first. Available to Personal and enterprise accounts. Manual top-ups and automatic reloads are distinguished by entry metadata; this narrow history does not expose provider charges, end-user rows, or margin data.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Top-up history page

- LedgerPage
  - `success` true, required
  - `entries` LedgerEntry[], required
    - `id` string, uuid, required
    - `direction` 'DEBIT' | 'CREDIT', required
    - `category` string, required
    - `amountUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `amountCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `balanceAfterUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `baseUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `marginUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
    - `markupBps` integer, nullable, required
    - `sourceKey` string, required
    - `externalReference` string, nullable, required
    - `externalUserId` string, nullable, required
    - `metadata` unknown, required
    - `createdAt` string, date-time, required
  - `nextCursor` string, nullable, required

## Other responses

- `403`: The authenticated management credential lacks one or more required scopes

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)