This guide walks you through buying a data bundle end-to-end.
Fund your wallet
Sign in to the dashboard and top up your balance. API purchases are debited from this balance. Buy a data bundle
Send an authenticated POST request to /api/data with a unique request-id.curl -X POST "https://api.mysubwallet.ng/api/data" \
-H "Authorization: Token your_api_key" \
-H "Content-Type: application/json" \
-d '{
"network": 1,
"phone": "2347013397088",
"data_plan": 1,
"bypass": false,
"request-id": "Data_12345678900"
}'
Read the response
A status of success means the bundle was delivered and your wallet was debited.{
"network": "MTN",
"request-id": "Data_12345678900",
"amount": "100",
"dataplan": "500MB",
"status": "success",
"message": "You have gifted 500MB to 2347013397088.",
"phone_number": "2347013397088",
"newbal": 110225,
"system": "API"
}
That’s it — you’ve made your first API purchase. Browse the API Reference for every available endpoint. Network IDs
Most endpoints accept a numeric network ID:
| ID | Network |
|---|
| 1 | MTN |
| 2 | Airtel |
| 3 | Glo |
| 4 | 9mobile |
Data and cable plans use plan IDs that you can fetch from the dashboard’s Pricing & Plan IDs page or the relevant catalog endpoint.
