> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenumero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Initiate Bulk Transfer

> Send money to multiple bank accounts in a single request.

Send money to multiple bank accounts in a single request.

## Endpoint

```
POST /api/v1/business/bulk
```

**Signature required:** Yes

## Headers

| Header                       | Required | Description                                                                                                                                                                    |
| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `X-Numero-Api-Key`           | Yes      | Your API key                                                                                                                                                                   |
| `X-Numero-Signature`         | Yes      | Base64 HMAC-SHA256 over the exact raw request body (POST) or the canonicalised query string (GET), keyed with your **Public Key**. See [Request signing](/03-request-signing). |
| `X-Numero-Signature-Version` | Yes      | Always `v2`.                                                                                                                                                                   |
| `Idempotency-Key`            | Yes      | Unique key you generate per attempt. Replaying the same key returns the original result instead of moving money twice.                                                         |

## Request body

| Field             | Type   | Required | Description                         |
| ----------------- | ------ | -------- | ----------------------------------- |
| `transferRequest` | array  | Yes      | Array of transfer items (see below) |
| `phoneNumber`     | string | Yes      | Sender's phone number               |

### Transfer item object

| Field                      | Type    | Required | Description                 |
| -------------------------- | ------- | -------- | --------------------------- |
| `narration`                | string  | Yes      | Description of the transfer |
| `amount`                   | integer | Yes      | Amount in Naira             |
| `destinationAccountNumber` | string  | Yes      | Recipient's account number  |
| `destinationBankCode`      | string  | Yes      | Recipient's bank code       |
| `destinationAccountName`   | string  | Yes      | Recipient's account name    |

## Request example

```bash theme={null}
curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/bulk" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "phoneNumber": "08012345678",
    "transferRequest": [
      {
        "narration": "Salary - January",
        "amount": 150000,
        "destinationAccountNumber": "0123456789",
        "destinationBankCode": "000013",
        "destinationAccountName": "John Doe"
      },
      {
        "narration": "Salary - January",
        "amount": 200000,
        "destinationAccountNumber": "9876543210",
        "destinationBankCode": "000014",
        "destinationAccountName": "Jane Smith"
      }
    ]
  }'
```

## Response

```json theme={null}
{
  "data": {
    "transferReference": [
      "TRF-20240115-abc123",
      "TRF-20240115-def456"
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```

| Field               | Type      | Description                     |
| ------------------- | --------- | ------------------------------- |
| `transferReference` | string\[] | One reference per transfer item |