Check an airtime purchase

GET

/v1/airtime/b2b/{reference}

The current status of an airtime purchase. While it is PROCESSING this checks with the network, so poll it until it is SUCCESS or FAILED.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/airtime/b2b/' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "success": true,
    "message": "Request successful",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "reference": "DB-AIR-20250923-MFX2K9QZ-4C8E91A2",
        "type": "AIRTIME",
        "status": "PROCESSING",
        "amount": 485,
        "recipient": "08012345678",
        "network": "MTN",
        "planId": null,
        "description": "MTN airtime ₦500",
        "tokenOrPin": null,
        "balanceBefore": 10000,
        "balanceAfter": 9520,
        "failureReason": null,
        "createdAt": "2026-09-26T12:00:00.000Z"
    }
}

Modified at 2026-10-05 17:27:33

List airtime networks

Pay for electricity