List bulk requests

GET

https://api.paybeta.ng/v2/bulk-airtime

Your bulk airtime requests, newest first (without the per-recipient list).

Request

Authorization

Add parameter in header

P-API-KEY

Example:

P-API-KEY: ********************

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paybeta.ng/v2/bulk-airtime?per_page=20&page=1' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'P-API-KEY: <api-key>' \
--header 'Content-Type: application/json'

Response Example

{
  "status": "successful",
  "message": "Bulk airtime requests retrieved successfully",
  "data": [
    {
      "reference": "PAYROLL-OCT",
      "batch_id": "BLK-K3P9XQ2M7Z1A",
      "description": "October staff airtime",
      "status": "completed",
      "total_recipients": 3,
      "total_amount": 1700.0,
      "total_charge": 1644.0,
      "amount_charged": 1450.0,
      "summary": {
        "successful": 1,
        "pending": 1,
        "failed": 1,
        "queued": 0,
        "cancelled": 0
      },
      "created_at": "2026-10-05T09:00:00+01:00",
      "started_at": "2026-10-05T09:00:02+01:00",
      "completed_at": "2026-10-05T09:00:14+01:00",
      "cancelled_at": null
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 20,
    "total": 1
  }
}

Modified at 2026-10-06 21:07:01

Send bulk airtime

Get bulk request