---
title: "Retrieve Ledger"
method: GET
path: "/v2/clients/{ClientID}/ledgers/{LedgerID}"
tags: ["Ledger"]
---

# Retrieve Ledger

`GET /v2/clients/{ClientID}/ledgers/{LedgerID}`

Retrieves a ledger by ledgerID.

## Path parameters

- `ClientID` string, required
- `LedgerID` string, required

## Query parameters

- `referenceID` string

## Response `200`

Ledger retrieved.

- RetrieveLedgerResponse
  - `SC` integer — [HTTP Status Code](https://developers.tabapay.com/reference/http-status-codes#/)
  - `EC` string — Internal Error Code. This is used to help TabaPay team members trace an error.
  - `EM` string — Short description of the error if an error occurred.
  - `ledgerID` string — TabaPay ledger identifier
  - `referenceID` string — Client-defined reference identifier
  - `userID` string — TabaPay user identifier
  - `bank` string
  - `type` 'BalanceHolding' | 'Passthrough'
  - `routingNumber` string
  - `accountNumber` string
  - `currency` string — ISO-4217 numeric currency code
  - `balance` object
    - `ledger` number
    - `available` number
  - `created` string, date-time
  - `updated` string, date-time

## Other responses

- `404` — Ledger not found.

---

[API](https://skmtc.dev/tabapay/apis/tabapay-apis.md) · [All operations](https://skmtc.dev/tabapay/apis/tabapay-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tabapay/tabapay-apis/revisions/154fa3d585cf/schema)