POST /transfer/ledger/distribute

Use the /transfer/ledger/distribute endpoint to move available balance between the ledgers of the platform and one of its originators.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
description String No

An optional description for the ledger distribute operation.

client_id String No

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.

to_ledger_id String Yes

The Ledger to credit money to.

amount String Yes

The amount to move (decimal string with two digits of precision e.g. "10.00"). Amount must be positive.

from_ledger_id String Yes

The Ledger to pull money from.

secret String No

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.

idempotency_key String Yes

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.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.