---
title: "Own ledger (end-user)"
method: GET
path: "/credits/me/ledger"
tags: ["Widget"]
---

# Own ledger (end-user)

`GET /credits/me/ledger`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/me/ledger`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `X-Locus-Publishable-Key`

Returns newest-first transaction history for the end user encoded in the bearer token. The caller cannot select another externalUserId. Entries include charges, top-ups, allocations, refunds, and other posted balance movements. End-user responses redact base cost, markup, margin, tenant identifiers, and internal pricing configuration.

## Query parameters

- `cursor` string
- `limit` integer

## Headers

- `X-Locus-Session-Id` string

## Response `200`

End-user transaction history with internal pricing fields redacted.

- 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

---

[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)