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=2&phoneNumber=09067879810
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, network is MTN, dataPlan = 2, 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 |
1.0GB |
43 |
SME2 |
7 days |
2.0GB |
44 |
SME2 |
30days |
3.0GB |
45 |
SME2 |
30days |
5.0GB |
46 |
SME2 |
30days |
1GB |
2 |
SME |
7 Days |
2GB |
3 |
SME |
(30 Days) |
5GB |
5 |
SME |
(30 Days) |
10GB |
6 |
SME |
(30 Days) |
1.0GB |
9 |
CORPORATE GIFTING |
(7 Days) |
2.0GB |
10 |
CORPORATE GIFTING |
(30 Days) |
3.0GB |
11 |
CORPORATE GIFTING |
(30 Days) |
75MB |
25 |
GIFTING |
1 day |
110MB |
26 |
GIFTING |
1 days |
230MB |
27 |
GIFTING |
1 day |
1.5GB |
28 |
GIFTING |
2 days |
2.0GB |
29 |
GIFTING |
2 days |
750.0MB |
30 |
GIFTING |
3 days |
10.00GB |
31 |
GIFTING |
30 days |
2.5GB |
32 |
GIFTING |
2 days |
20.0GB |
33 |
DATA AWOOF |
7 days |
1.5 GB |
34 |
GIFTING |
7 days |
7.000GB |
35 |
DATA AWOOF |
30 days |
20.0GB |
36 |
GIFTING |
30 days |
6.0GB |
37 |
GIFTING |
7 days |
25GB |
39 |
GIFTING |
30 days |
36GB |
40 |
GIFTING |
30 days |
GLO:
Data Bundle |
dataPlan |
Type |
Durations |
750MB |
1 |
SME |
1 day |
1.5GB |
2 |
SME |
1 day |
2.5GB |
3 |
SME |
2 days |
10GB |
4 |
SME |
7 days |
200.0MB |
12 |
CORPORATE GIFTING |
(30 Days) |
500.0MB |
13 |
CORPORATE GIFTING |
(30 Days) |
1.0GB |
14 |
CORPORATE GIFTING |
(30 Days) |
2.0GB |
15 |
CORPORATE GIFTING |
(30 Days) |
3.0GB |
16 |
CORPORATE GIFTING |
(30 Days) |
5.0GB |
17 |
CORPORATE GIFTING |
(30 Days) |
10GB |
18 |
CORPORATE GIFTING |
(30 Days) |
AIRTEL:
Data Bundle |
dataPlan |
Type |
Durations |
100MB |
1 |
CORPORATE GIFTING |
(7 Days) |
300MB |
2 |
CORPORATE GIFTING |
(1 Month) |
500MB |
3 |
CORPORATE GIFTING |
(MONTHLY) |
1GB |
4 |
CORPORATE GIFTING |
(MONTHLY) |
2GB |
5 |
CORPORATE GIFTING |
(MONTHLY) |
5GB |
6 |
CORPORATE GIFTING |
(MONTHLY) |
1.0GB |
18 |
AWOOF GIFTING |
1 days |
600.0MB |
19 |
AWOOF GIFTING |
1 days |
1.5GB |
20 |
AWOOF GIFTING |
7 days |
1.0GB |
24 |
GIFTING |
1 day |
1.5GB |
25 |
GIFTING |
2 days |
2.0GB |
26 |
GIFTING |
2 days |
1.0GB |
27 |
GIFTING |
7 days |
2.0GB |
28 |
GIFTING |
2 days |
10GB |
29 |
GIFTING |
1 month |
7GB |
30 |
GIFTING |
7 days |
9MOBILE:
Data Bundle |
dataPlan |
Type |
Durations |
500MB |
1 |
GIFTING |
(30 Days) |
1.5GB |
2 |
GIFTING |
(30 Days) |
2GB |
3 |
GIFTING |
(30 Days) |
3GB |
4 |
GIFTING |
(30 Days) |
4.5GB |
5 |
GIFTING |
(30 Days) |
1GB |
6 |
SME |
(30 Days) |
5GB |
7 |
SME |
(30 Days) |
1.50GB |
8 |
SME |
(30 Days) |
2.0GB |
9 |
SME |
(30 Days) |