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 |
30 days |
| 2.0GB |
44 |
SME2 |
30days |
| 3.0GB |
45 |
SME2 |
30days |
| 5.0GB |
46 |
SME2 |
30days |
| 1GB |
2 |
SME |
30 Days |
| 2GB |
3 |
SME |
(30 Days) |
| 500MB |
4 |
SME |
(7 Days) |
| 90GB |
5 |
GIFTING |
(2 month) |
| 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 |
| 1.0GB |
47 |
SME2 |
7 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) |
| 3GB |
5 |
SME |
3days |
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 |
| 4.0GB |
21 |
AWOOF GIFTING |
2 days |
| 7.0GB |
22 |
AWOOF GIFTING |
7 days |
| 10.0GB |
23 |
AWOOF GIFTING |
30 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) |
| 500MB |
6 |
COOPERATE GIFTING |
(30 Days) |
| 1GB |
7 |
COOPERATE GIFTING |
(30 Days) |
| 1.5 GB |
8 |
COOPERATE GIFTING |
(30 Days) |
| 2.0GB |
9 |
COOPERATE GIFTING |
(30 Days) |
