Parameters:
| Parameter_Name |
Description |
| username |
Your Subremit username |
| apiKey |
Your Subremit API Key |
| network |
MTN, GLO, AIRTEL or 9MOBILE (UPPERCASE) |
| dataPlan |
data plan code, click Here to see |
| phoneNumber |
recipient number |
API Command:
https://subremit.com/api/data.php?username=****&apiKey=****&network=****&dataPlan=****&phoneNumber=****
//Replace **** with your username, api key...
E.g.
https://subremit.com/api/data.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&network=MTN&dataPlan=1GB&phoneNumber=09067879810
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, network is MTN, dataPlan = 1GB, phoneNumber is 09067879810
Response:
JSON Format:
{"status":"Approved","trans_id":"88c4r5one73","network":"MTN","dataPlan":"1GB","phoneNumber":"09067879810","balance":"2500"}
Else, if there is an error in your request, one of the responses below will be displayed in this format:
{"error":"ERR201","description":"Invalid Username or Api Key"}
status can be - Approved or Cancelled
Responses:
| Error |
Description |
| ERR200 |
Username Field Is Empty |
| ERR201 |
Invalid Username or Api Key |
| ERR202 |
Invalid Recipient number |
| ERR203 |
Insufficient Balance |
| ERR204 |
Invalid Network |
| ERR206 |
Order Not Processed |
| ERR207 |
Data Plan does not tally with Network |
API Query:
https://subremit.com/api/query_data.php?username=****&apiKey=****&trans_id=****
//Replace **** with your username, api key...
E.g.
https://subremit.com/api/query_data.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&trans_id=88c4r5one73
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, trans_id is 88c4r5one73
Response:
JSON Format:
{"status":"Approved","trans_id":"88c4r5one73","network":"MTN","phoneNumber":"09067879810","amount":"235","dataPlan":"1GB"}
Else, if there is an error in your request, response will be displayed in this format:
{"error":"ERR210","description":"Transaction not found on Subremit"}
MTN:
| Data Bundle |
dataPlan |
Type |
Durations |
| 500MB |
500MB |
SME |
(30 Days) |
| 1GB |
1GB |
SME |
(30 Days) |
| 2GB |
2GB |
SME |
(30 Days) |
| 3GB |
3GB |
SME |
(30 Days) |
| 5GB |
5GB |
SME |
(30 Days) |
| 10GB |
10GB |
SME |
(30 Days) |
| 500.0MB |
500.0MB |
CORPORATE GIFTING |
(30 Days) |
| 1.0GB |
1.0GB |
CORPORATE GIFTING |
(30 Days) |
| 2.0GB |
2.0GB |
CORPORATE GIFTING |
(30 Days) |
| 3.0GB |
3.0GB |
CORPORATE GIFTING |
(30 Days) |
| 5.0GB |
5.0GB |
CORPORATE GIFTING |
(30 Days) |
| 10.0GB |
10.0GB |
CORPORATE GIFTING |
(30 Days) |
| 20.0GB |
20.0GB |
CORPORATE GIFTING |
(30 Days) |
| 1.0GB |
1.0GB |
DATA AWOOF |
1 day |
| 3.5GB |
3.5GB |
DATA AWOOF |
2 days |
| 15.0GB |
15.0GB |
DATA AWOOF |
1 week |
GLO:
| Data Bundle |
dataPlan |
Type |
Durations |
| 500.0MB |
500.0MB |
CORPORATE GIFTING |
(30 Days) |
| 1.0GB |
1.0GB |
CORPORATE GIFTING |
(30 Days) |
| 2.0GB |
2.0GB |
CORPORATE GIFTING |
(30 Days) |
| 3.0GB |
3.0GB |
CORPORATE GIFTING |
(30 Days) |
| 5.0GB |
5.0GB |
CORPORATE GIFTING |
(30 Days) |
| 10GB |
10GB |
CORPORATE GIFTING |
(30 Days) |
AIRTEL:
| Data Bundle |
dataPlan |
Type |
Durations |
| 100MB |
100MB |
CORPORATE GIFTING |
(7 Days) |
| 300MB |
300MB |
CORPORATE GIFTING |
(7 Days) |
| 500MB |
500MB |
CORPORATE GIFTING |
(MONTHLY) |
| 1GB |
1GB |
CORPORATE GIFTING |
(MONTHLY) |
| 2GB |
2GB |
CORPORATE GIFTING |
(MONTHLY) |
| 5GB |
5GB |
CORPORATE GIFTING |
(MONTHLY) |
| 15GB |
15GB |
CORPORATE GIFTING |
(MONTHLY) |
| 20GB |
20GB |
CORPORATE GIFTING |
(MONTHLY) |
| 1.0GB |
1.0GB |
SME |
(30 Days) |
| 2.0GB |
2.0GB |
SME |
(30 Days) |
| 5.0GB |
5.0GB |
SME |
(30 Days) |
| 10.0GB |
10.0GB |
SME |
(30 Days) |
9MOBILE:
| Data Bundle |
dataPlan |
Type |
Durations |
| 500MB |
500MB |
GIFTING |
(30 Days) |
| 1.5GB |
1.5GB |
GIFTING |
(30 Days) |
| 2GB |
2GB |
GIFTING |
(30 Days) |
| 3GB |
3GB |
GIFTING |
(30 Days) |
| 4.5GB |
4.5GB |
GIFTING |
(30 Days) |
| 1GB |
1GB |
SME |
(30 Days) |
| 5GB |
5GB |
SME |
(30 Days) |
| 1.50GB |
1.50GB |
SME |
(30 Days) |
| 2.0GB |
2.0GB |
SME |
(30 Days) |
