---
title: "Send payment in batch"
method: POST
path: "/v3/ledger/transaction/batch"
tags: ["Transaction"]
---

# Send payment in batch

`POST /v3/ledger/transaction/batch`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/ledger/transaction/batch`
- Auth: API key in header `x-api-key`

/v3/ledger/transaction/batch

#### 2 + 2 \* N per API call. (N - count of transactions)

  

Sends the N payments within Tatum Private Ledger. All assets are settled instantly.  
When a transaction is settled, 2 transaction records are created, 1 for each of the participants. These 2 records are connected via a transaction reference, which is the same for both of them.  
This method is only used for transferring assets between accounts within Tatum and will not send any funds to blockchain addresses.  
If there is an insufficient balance in the sender account, no transaction is recorded.  
It is possible to perform an anonymous transaction where the sender account is not visible for the recipient.  
The FIAT currency value of every transaction is calculated automatically. The FIAT value is based on the accountingCurrency of the account connected to the transaction and is available in the marketValue parameter of the transaction.

## Request body

- BatchCreateTransaction
  - `senderAccountId` string, required: Internal sender account ID within Tatum platform
  - `transaction` object[]: Array of block seals.
    - `recipientAccountId` string, required: Internal recipient account ID within Tatum platform
    - `amount` string, required: Amount to be sent.
    - `anonymous` boolean: Anonymous transaction does not show sender account to recipient, default is false
    - `compliant` boolean: Enable compliant checks. Transaction will not be processed, if compliant check fails.
    - `transactionCode` string: For bookkeeping to distinct transaction purpose.
    - `paymentId` string: Payment ID, External identifier of the payment, which can be used to pair transactions within Tatum accounts.
    - `recipientNote` string: Note visible to both, sender and recipient
    - `baseRate` number: Exchange rate of the base pair. Only applicable for Tatum's Virtual currencies Ledger transactions. Override default exchange rate for the Virtual Currency.
    - `senderNote` string: Note visible to sender

## Response `200`

OK

- string[]

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/tatum/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/virtual-accounts/revisions/ba220553084b?raw)