Endpoint
POST /api/v1/business/bulk
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. |
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
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
{
"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 |