# List bulk requests

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

Authentication: `P-API-KEY` header.

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

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | no | queued, processing, completed, cancelled |
| `reference` | string | no | your request reference |
| `per_page` | string | yes | max 50 |
| `page` | string | yes |  |

## Response 200: Success

```json
{
    "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
    }
}
```