POST/v1/purchase/airtime | /v1/purchase/data

Airtime & Mobile Data APIs

Automate instant airtime top-ups and mobile data bundle provisioning across all major Nigerian mobile operators (MTN, Airtel, Glo, 9mobile).

1. Buy Airtime

Field	Type	Required	Description
amount	number	Required	Amount in NGN (e.g. 500).
destination	string[] \| string	Required	Recipient number or array of numbers to top up.

cURL Request (Airtime)

curl -X POST https://api.verixaid.com/v1/purchase/airtime \
  -H "Authorization: Bearer vrx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "destination": ["2348012345678"]
  }'

2. Buy Data Bundle

Field	Type	Required	Description
plan	string	Required	Bundle plan code (e.g. MTN_1GB, 9MOBILE_1.5GB).
destination	string \| number	Required	Recipient phone number.

cURL Request (Data)

curl -X POST https://api.verixaid.com/v1/purchase/data \
  -H "Authorization: Bearer vrx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "9MOBILE_1.5GB",
    "destination": "2348012345678"
  }'

3. Fetch Available Data Plans

Query all available live network data packages and their exact plan codes:

cURL Request (Fetch Plans)

curl -X GET https://api.verixaid.com/v1/purchase/data-plans \
  -H "Authorization: Bearer vrx_live_..."