POST
/
transactions
/
bulk
Bulk transactions
curl --request POST \
  --url http://localhost:5001/transactions/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-blnk-key: <api-key>' \
  --data '{
  "atomic": true,
  "inflight": true,
  "run_async": true,
  "skip_queue": true,
  "transactions": [
    {}
  ]
}'

​
Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>.

Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.

See also: Secure your Blnk server

​
Body

​
atomic
boolean
required

When true, either all transactions succeed or all fail. When false, transactions are processed independently.

​
inflight
boolean
required

When true, transactions are created in INFLIGHT status and require a separate commit. When false, transactions are applied immediately.

​
run_async
boolean
default:"false"

When true, processing happens in the background and results are delivered via webhook. When false or not provided, processing happens synchronously and results are returned in the response.

​
skip_queue
boolean
default:"false"

When true, transactions bypass the queue system. Learn more: Why we use queueing.

​
transactions
object[]
required

An array of transaction objects.

Sample transaction object
{
  "amount": 358.90,
  "precision": 100,
  "reference": "unique_reference_1",
  "description": "Transaction description",
  "currency": "USD",
  "source": "@source_account",
  "destination": "@destination_account",
  "allow_overdraft": true
}