Skip to main content
POST
/
bulk-transfers
Create a Bulk Transfer
curl --request POST \
  --url https://api.flutterwave.com/v3/bulk-transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Test_ZAR_Bulk_Transfers_1",
  "bulk_data": [
    {
      "bank_code": "FNB",
      "account_number": "0031625807099",
      "amount": 1900,
      "currency": "ZAR",
      "narration": "Test transfer to Lisa",
      "reference": "bulk_Transfers_0019_PMCK",
      "meta": [
        {
          "first_name": "Lisa",
          "last_name": "Wayne",
          "email": "test@test.com",
          "mobile_number": "+23457558595",
          "recipient_address": "234 Kings road, Cape Town"
        }
      ]
    },
    {
      "bank_code": "FNB",
      "account_number": "0031625807099",
      "amount": 3200,
      "currency": "ZAR",
      "narration": "Test transfer to Daemon",
      "reference": "bulk_Transfers_0020_PMCK",
      "meta": [
        {
          "first_name": "Daemon",
          "last_name": "Philips",
          "email": "test@test.com",
          "mobile_number": "+23457558595",
          "recipient_address": "234 Kings road, Cape Town"
        }
      ]
    },
    {
      "bank_code": "FNB",
      "account_number": "0031625807099",
      "amount": 6950,
      "currency": "ZAR",
      "narration": "Test transfer to John",
      "reference": "bulk_Transfers_0021_PMCK",
      "meta": [
        {
          "first_name": "John",
          "last_name": "Kolapo",
          "email": "test@test.com",
          "mobile_number": "+23457558595",
          "recipient_address": "234 Kings road, Cape Town"
        }
      ]
    },
    {
      "bank_code": "FNB",
      "account_number": "0031625807099",
      "amount": 1500,
      "currency": "ZAR",
      "narration": "Test transfer to Kara",
      "reference": "bulk_Transfers_0022_PMCK",
      "meta": [
        {
          "first_name": "Kara",
          "last_name": "Johnson",
          "email": "test@test.com",
          "mobile_number": "+23457558595",
          "recipient_address": "234 Kings road, Cape Town"
        }
      ]
    }
  ]
}
'
{
  "status": "success",
  "message": "Bulk transfer queued",
  "data": {
    "id": 2013,
    "created_at": "2020-01-20T16:36:29.000Z",
    "approver": "N/A"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
title
string
required
​
bulk_data
BulkDatum1 · object[]
required

Response

OK

​
status
string
required
​
message
string
required
​
data
Data34 · object
required
Example:
{
  "id": 2013,
  "created_at": "2020-01-20T16:36:29.000Z",
  "approver": "N/A"
}