---
title: "POST /v1/transactions/batch"
method: POST
path: "/v1/transactions/batch"
tags: ["transactions"]
---

# POST /v1/transactions/batch

`POST /v1/transactions/batch`

## Request

- Base URL: `https://apibusiness-staging-civ.djamo.io`
- URL: `https://apibusiness-staging-civ.djamo.io/v1/transactions/batch`
- Auth: HTTP bearer

## Request body

- TransactionBatchParams
  - `transactions` unknown[], required: List of the transactions to perform.
    - unknown

## Response `200`

- TransactionBatch
  - `id` string, required: Universal Unique Identifier for the object.
  - `createdAt` string, required: Date and time when the object was created. The API returns this value in ISO 8601 format.
  - `updatedAt` string, required: Date and time when the object was updated. The API returns this value in ISO 8601 format.
  - `totalAmount` integer, required: The total amount .
  - `status` 'pending' | 'processing' | 'failed' | 'done', required: Status of the job
  - `totalFee` number, required: Fee applied.
  - `transactions` Transaction[], required
    - `id` string, required: Universal Unique Identifier for the object.
    - `createdAt` string, required: Date and time when the object was created. The API returns this value in ISO 8601 format.
    - `updatedAt` string, required: Date and time when the object was updated. The API returns this value in ISO 8601 format.
    - `amount` integer, required: The amount to transfer.
    - `fee` number, required: Fee applied.
    - `totalAmount` number, required: Total amount
    - `status` 'pending' | 'failed' | 'pending_provider' | 'completed', required: Status of the transaction
    - `msisdn` string, required: The recipient phone number.
    - `reference` string, required: The unique identifier of the transaction on your side.
    - `failureReason` string, required: The reason why the transaction has failed. Available only for failed transaction.
    - `description` string, required: Description for the receiver
    - `type` 'transfer', required: Transaction type.
    - `batchId` 'transfer', required: Unique identifier of the batch
    - `metadata` object: Key-value pairs attached to the transaction. `null` if none was provided.

## Other responses

- `404`

---

[API](https://skmtc.dev/djamo/apis/djamo-business-api-playground.md) - [All operations](https://skmtc.dev/djamo/apis/djamo-business-api-playground/llms.txt) - [OpenAPI document](https://skmtc.dev/djamo/apis/djamo-business-api-playground/revisions/e7f36f4cab53?raw)
