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 |
7 days |
1GB |
1GB |
SME |
7 Days |
2GB |
2GB |
SME |
(30 Days) |
3.5GB |
3.5GB |
SME |
(30 Days) |
5GB |
5GB |
SME |
(30 Days) |
10GB |
10GB |
SME |
(30 Days) |
3.0GB |
3.0GB |
CORPORATE GIFTING |
(30 Days) |
5.00GB |
5.00GB |
SME 2 |
1 month |
1.5GB |
1.5GB |
GIFTING |
2 days |
2.00GB |
2.00GB |
GIFTING |
2 days |
750.0MB |
750.0MB |
GIFTING |
3 days |
10.00GB |
10.00GB |
GIFTING |
30 days |
2.5GB |
2.5GB |
GIFTING |
2 days |
1.5 GB |
1.5 GB |
GIFTING |
7 days |
20.0GB |
20.0GB |
GIFTING |
30 days |
6.0GB |
6.0GB |
GIFTING |
7 days |
1GB |
1GB |
GIFTING |
1 DAY |
25GB |
25GB |
GIFTING |
30 days |
36GB |
36GB |
GIFTING |
30 days |
GLO:
Data Bundle |
dataPlan |
Type |
Durations |
200.0MB |
200.0MB |
CORPORATE GIFTING |
(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) |
10GB |
10GB |
CORPORATE GIFTING |
(30 Days) |
AIRTEL:
Data Bundle |
dataPlan |
Type |
Durations |
500MB |
500MB |
CORPORATE GIFTING |
(MONTHLY) |
1GB |
1GB |
CORPORATE GIFTING |
(MONTHLY) |
2GB |
2GB |
CORPORATE GIFTING |
(MONTHLY) |
1.0GB |
1.0GB |
AWOOF GIFTING |
1 days |
600.0MB |
600.0MB |
AWOOF GIFTING |
2 days |
3.0GB |
3.0GB |
AWOOF GIFTING |
7 days |
7.0GB |
7.0GB |
AWOOF GIFTING |
7 days |
10.0GB |
10.0GB |
AWOOF GIFTING |
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) |