Skip to main content
Send money to multiple bank accounts in a single request.

​
Endpoint

POST /api/v1/business/bulk
Signature required: Yes

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key
x-signature-keyYesRequest signature

​
Request body

FieldTypeRequiredDescription
transferRequestarrayYesArray of transfer items (see below)
phoneNumberstringYesSender’s phone number

​
Transfer item object

FieldTypeRequiredDescription
narrationstringYesDescription of the transfer
amountintegerYesAmount in Naira
destinationAccountNumberstringYesRecipient’s account number
destinationBankCodestringYesRecipient’s bank code
destinationAccountNamestringYesRecipient’s account name

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/bulk" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -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

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "transferReference": [
      "TRF-20240115-abc123",
      "TRF-20240115-def456"
    ]
  },
  "error": null
}
FieldTypeDescription
transferReferencestring[]One reference per transfer item