Skip to main content
POST
/
transactions
/
bulk
Bulk transactions
curl --request POST \
  --url http://localhost:5001/transactions/bulk \
  --header 'X-blnk-key: <api-key>'
Use blnk.Transactions.createBulk to create many transactions in one request.
blnk.Transactions.createBulk
const response = await blnk.Transactions.createBulk({
  atomic: true,
  transactions: [
    {
      amount: 1000,
      precision: 100,
      currency: 'USD',
      source: '@source_1',
      destination: '@dest_1',
      reference: 'bulk_001',
      description: 'Payment 1',
    },
    {
      amount: 2000,
      precision: 100,
      currency: 'USD',
      source: '@source_2',
      destination: '@dest_2',
      reference: 'bulk_002',
      description: 'Payment 2',
    },
  ],
});
FieldDescription
transactionsTransaction objects to create; references must be unique within the batch.
atomicWhen true, every transaction succeeds or fails together.
inflightWhen true, transactions are created in INFLIGHT status for a later commit or void.
run_asyncWhen true, Core processes the batch in the background and returns status: 'queued'.
skip_queueWhen true, transactions bypass the queue and process synchronously.

​
Response shape

{
  "batch_id": "bulk_c62f200b-905f-4983-a349-cadd279234aa",
  "status": "applied",
  "transaction_count": 4
}
FieldDescription
batch_idIdentifier for the batch. Use as parent_transaction to find child transactions, or with updateStatus to commit or void an inflight batch.
statusapplied, inflight, or queued depending on the batch.
transaction_countNumber of transactions when processed synchronously.
messageStatus message when run_async is true.

Bulk transactions guide

Batch processing, webhooks, and retrieving a batch.

Bulk transactions

HTTP request and response schema.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.