---
title: "Move available balance between ledgers"
method: POST
path: "/transfer/ledger/distribute"
tags: ["plaid"]
---

# Move available balance between ledgers

`POST /transfer/ledger/distribute`

Use the `/transfer/ledger/distribute` endpoint to move available balance between ledgers, if you have multiple. If you're a platform, you can move funds between one of your ledgers and one of your customer's ledgers.

## Request body

- TransferLedgerDistributeRequest — Defines the request schema for `/transfer/ledger/distribute`
  - `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.
  - `from_ledger_id` string, required — The Ledger to pull money from.
  - `to_ledger_id` string, required — The Ledger to credit money to.
  - `amount` string, required — The amount to move (decimal string with two digits of precision e.g. "10.00"). Amount must be positive.
  - `idempotency_key` string, required — A unique key provided by the client, per unique ledger distribute. Maximum of 50 characters. The API supports idempotency for safely retrying the request without accidentally performing the same operation twice. For example, if a request to create a ledger distribute fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single distribute is created.
  - `description` string — An optional description for the ledger distribute operation.

## Response `200`

OK

- TransferLedgerDistributeResponse — Defines the response schema for `/transfer/ledger/distribute`
  - `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

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)