---
title: "Ledger entry"
method: GET
path: "/wallets/{wallet_token}/ledger/{ledger_transaction_token}"
tags: ["Ledger"]
---

# Ledger entry

`GET /wallets/{wallet_token}/ledger/{ledger_transaction_token}`

## Request

- Base URL: `https://api.masspay.io/v1.0.0`
- URL: `https://api.masspay.io/v1.0.0/wallets/{wallet_token}/ledger/{ledger_transaction_token}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/masspay/apis/masspay-api/docs/wallets/:wallet_token/ledger/:ledger_transaction_token/get.ts> (a function with typed inputs; its response is checked against the schema)

This **GET** endpoint is used to retrieve a single ledger entry for a wallet with the provided wallet token. <br> You can use this endpoint to obtain the details of a specific balance movement, such as a payout, payin, load, spendback, fee, credit, or reversal, identified by its ledger entry token. <br> To use this endpoint, you need to provide the `wallet_token` and the `ledger_transaction_token` as parameters in the URL Path. <br> The response will contain a single JSON ledger entry object including entry details.

## Headers

- `Idempotency-Key` string

## Response `200`

Succesful operation.

- LedgerEntry
  - `token` string, required: Prefixed ledger entry identifier.
  - `wallet_token` string, required: Prefixed wallet identifier. User wallets use the `usr_wlt_` prefix and client wallets use the `clnt_wlt_` prefix.
  - `user_token` string: Prefixed user identifier.
  - `metadata` object: Optional JSON object with attributes associated with the transaction
  - `amount` number, double, required: Signed amount of the entry in the wallet's currency, with up to two decimal places. Negative values decrease the wallet balance.
  - `currency_code` string, required: Currency code of the wallet in which the entry is denominated. Three-letter ISO 4217 codes for fiat currencies (e.g. `USD`) and up to five characters for cryptocurrencies (e.g. `USDC`, `MATIC`).
  - `timestamp` string, date-time, required: Time at which the entry was recorded, ISO 8601 with millisecond precision.
  - `notes` string, required: Free-form notes attached to the entry.
  - `type` 'payout' | 'payout_cancel' | 'payout_reversal' | 'payin' | 'payin_reversal' | 'payin_deposit_return' | 'topup' | 'topup_reversal' | 'service_fee' | 'wallet_credit' | 'wallet_debit' | 'spendback' | 'load' | 'load_reversal' | 'spendback_reversal', required: The kind of ledger movement.
  - `ref_token` string: Prefixed token of a source transaction object, such as a payout, payin, top-up, load, or spendback. The prefix identifies the resource type.
  - `ref_tokens` SourceTransactionToken[]: Tokens of the source transactions that produced this ledger entry, such as a payout, payin, top-up, load, or spendback. Null for entries with no associated source object.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not found.
- `405`: Method Not Allowed.
- `500`: Internal server error.
- `504`: Gateway Time-out.

## Changes

- **2026-11-03** `f9fa41b7c45c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/masspay/apis/masspay-api/changes/wallets/:wallet_token/ledger/:ledger_transaction_token/get.md)

---

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