---
title: "Retrieve Plaid Ledger balance"
method: POST
path: "/transfer/ledger/get"
tags: ["plaid"]
---

# Retrieve Plaid Ledger balance

`POST /transfer/ledger/get`

Use the `/transfer/ledger/get` endpoint to view a balance on the ledger held with Plaid.

## Request body

- TransferLedgerGetRequest — Defines the request schema for `/transfer/ledger/get`
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `ledger_id` string, nullable — Specify which ledger balance to get. Customers can find a list of `ledger_id`s in the Accounts page of your Plaid Dashboard. If this field is left blank, this will default to id of the default ledger balance.
  - `originator_client_id` string, nullable — Client ID of the end customer.

## Response `200`

OK

- TransferLedgerGetResponse — Defines the response schema for `/transfer/ledger/get`
  - `ledger_id` string, required — The unique identifier of the Ledger that was returned.
  - `balance` TransferLedgerBalance, required — Information about the balance of the ledger held with Plaid.
    - `available` string, required — The amount of this balance available for use (decimal string with two digits of precision e.g. "10.00").
    - `pending` string, required — The amount of pending funds that are in processing (decimal string with two digits of precision e.g. "10.00").
  - `name` string, required — The name of the Ledger
  - `is_default` boolean, required — Whether this Ledger is the client's default ledger.
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Other responses

- `default` — Error response

## Changes

- **2025-03-26** `09cbc8444913` — 2 warning
  - added the new `CHECK_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `CONSUMER_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
- **2024-10-09** `36052f62cce1` — 3 info
  - added the required property `is_default` to the response with the `200` status
  - added the required property `ledger_id` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
- **2024-09-04** `a2c34406c317` — 5 warning, 2 info
  - added the new `PARTNER_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `SANDBOX_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `TRANSACTIONS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `TRANSACTION_ERROR` enum value to the `error_type` response property for the response status `default`
  - …3 more
- **2024-02-21** `5de70cc1e6ca` — 3 breaking, 4 warning, 11 info
  - removed the required property `is_default` from the response with the `200` status
  - removed the required property `ledger_id` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the request property `ledger_id`
  - …14 more

[Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/transfer/ledger/get/post.md)

---

[API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/5eae3158bbfc/schema)