Create a Bulk Transfer

Create a bulk transfer

POST /bulk-transfers

Create a Bulk Transfer

cURL

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": "[e-mail]",
          "mobile_number": "[phone]",
          "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": "[e-mail]",
          "mobile_number": "[phone]",
          "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": "[e-mail]",
          "mobile_number": "[phone]",
          "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": "[e-mail]",
          "mobile_number": "[phone]",
          "recipient_address": "234 Kings road, Cape Town"
        }
      ]
    }
  ]
}
'

200

{
  "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

Show child attributes

Response

200

application/json; charset=utf-8

OK

status · string · required

message · string · required

data · Data34 · object · required

Show child attributes

Example:

{
  "id": 2013,
  "created_at": "2020-01-20T16:36:29.000Z",
  "approver": "N/A"
}