VTU API
Get API keys
Buy Bulk Airtime API

List bulk requests

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

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

Send your secret key in the P-API-KEY header. Keep it on your server, never in an app or browser.

Query parameters

  • status string Optional

    queued, processing, completed, cancelled

    Example: completed
  • reference string Optional

    your request reference

    Example: PAYROLL-OCT
  • per_page string Required

    max 50

    Example: 20
  • page string Required
    Example: 1

Responses

  • 200Success
Request
curl --request GET \
  --url 'https://api.paybeta.ng/v2/bulk-airtime?status=completed&reference=PAYROLL-OCT&per_page=20&page=1' \
  --header 'Accept: application/json' \
  --header 'P-API-KEY: YOUR_SECRET_KEY'
Response
{
    "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,
            "total_charge": 1644,
            "amount_charged": 1450,
            "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
    }
}