Skip to main content
POST
/
bulk-bills
Create Bulk Bills Payment
curl --request POST \
  --url https://api.flutterwave.com/v3/bulk-bills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bulk_reference": "bulkRef0012",
  "callback_url": "https://www.google.com",
  "bulk_data": [
    {
      "country": "NG",
      "customer": "+2348029494025",
      "amount": 100,
      "recurrence": "WEEKLY",
      "type": "AIRTIME",
      "reference": "billRef05"
    },
    {
      "country": "NG",
      "customer": "+2347063932728",
      "amount": 100,
      "recurrence": "WEEKLY",
      "type": "AIRTIME",
      "reference": "billRef06"
    },
    {
      "country": "NG",
      "customer": "+2347013431382",
      "amount": 100,
      "recurrence": "WEEKLY",
      "type": "AIRTIME",
      "reference": "billRef07"
    },
    {
      "country": "NG",
      "customer": "+2348134088426",
      "amount": 100,
      "recurrence": "WEEKLY",
      "type": "AIRTIME",
      "reference": "billRef08"
    }
  ]
}
'
{
  "status": "success",
  "message": "Bulk bill Payment was queued for processing",
  "data": {
    "batch_reference": "CF-BATCH-FLY-API-20200310042210201008"
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
bulk_reference
string
required
​
callback_url
string
required
​
bulk_data
BulkDatum2 · object[]
required

Response

OK

​
status
string
required
​
message
string
required
​
data
Data77 · object
required
Example:
{
  "batch_reference": "CF-BATCH-FLY-API-20200310042210201008"
}