Airtime Topup

Recharge airtime seamlessly across all major Nigerian telecommunication networks.

Endpoint

POST /airtime

Headers

Header	Value	Required
`Authorization`	`Bearer YOUR_API_TOKEN`	Required
`Content-Type`	`application/json`	Required

Parameters

Parameter	Type	Description	Required
`network`	`string`	Network provider ID or name (e.g., MTN, GLO, AIRTEL, 9MOBILE).	Required
`phone`	`string`	The 11-digit phone number to recharge.	Required
`amount`	`numeric`	The amount in Naira (NGN) to recharge.	Required
`reference`	`string`	A unique transaction reference for tracking.	Required

Example Request

JSON Payload

{
    "network": "MTN",
    "phone": "08012345678",
    "amount": 500,
    "reference": "TXN_123456789"
}

Example Response

JSON

{
    "status": true,
    "message": "Airtime purchased successfully",
    "data": {
        "transaction_id": "ASI-123456789",
        "reference": "TXN_123456789",
        "network": "MTN",
        "phone": "08012345678",
        "amount": 500,
        "balance_before": 1500,
        "balance_after": 1000
    }
}