Skip to main content
POST
/
purchaseAirtime
curl --location 'https://api.bleeprs.com/api/purchaseAirtime' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '[
  {
    "amount": 50,
    "phoneNumber": "08107176819",
    "network": "mtn"
  }
]'

{
  "gatewayStatus": "<string>",
  "gatewayMessage": "<string>",
  "requestReference": "<string>",
  "data": "<string>"
}

​
Overview

Purchase airtime for any Nigerian phone number on supported networks. The airtime will be credited instantly to the recipient’s phone.

​
Request

curl --location 'https://api.bleeprs.com/api/purchaseAirtime' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '[
  {
    "amount": 50,
    "phoneNumber": "08107176819",
    "network": "mtn"
  }
]'

​
Request Body

​
Response

​
gatewayStatus
string
Status code indicating success (“00”) or error
​
gatewayMessage
string
Human-readable status message
​
requestReference
string
Unique reference ID for tracking this transaction
​
data
string
Status message about the airtime purchase

​
Example Response

{
  "gatewayStatus": "00",
  "gatewayMessage": "Sucessfully Processed",
  "requestReference": "JJqI1HCxemtGpMOWOESU",
  "data": "Airtime purchased processing"
}

​
Supported Networks

  • mtn - MTN Nigeria
  • airtel - Airtel Nigeria
  • globacom - Glo Nigeria
  • 9mobile - 9mobile Nigeria

​
Notes

  • Airtime is credited instantly to the recipient’s phone
  • Minimum purchase amount is ₦10
  • Maximum purchase amount varies by network (typically ₦30,000)
  • Phone numbers should be in Nigerian format (e.g., 08107176819)
  • Transaction processing may take a few seconds