Our API is a RESTful interface that enables seamless integration of our services into your application.
You are to pass your API token via the header 'Authorization' key for every request sent to our server. The value should be in the format "Token your-token" (where your-token is your API token). API Token can be found on the settings page of the user account.
We advise that you keep your API token as secret as possible. If you suspect that your API token has been compromised, login to your account and generate another API token as fast as possibe to render the former token invalid.
URL: They are stated in the latter part of this documentation
Method: POST
Header: It contains the 'Content-Type' (content format our server accepts), 'Accept' (format of response our server pushes back) and 'Authentication' key (API token).
Body/Content: The request body must be in json format. The fields/parameters are stated in the latter part of this documentation. All parameters are compulsory except stated otherwise.
Parameters:
Parameter | Description |
---|---|
curl --location 'https://toprechargeng.com/api/user/' \
--header 'Content-Type: application/json' \
--header 'authorization: Token 3782be88ad71277cad' \
--data '{
}'
{
"user": {
"wallet_balance": 1049.1
}
}
Parameters:
Parameter | Description |
---|---|
network | It can be either '1' for MTN, '2' for Glo, '3' for 9mobile or '4' for Airtel |
plan | This is the plan ID. Check BELOW for the full plan codes. |
mobile_number | Beneficiary phone number |
curl --location 'https://toprechargeng.com/api/data/' \
--header 'Content-Type: application/json' \
--header 'authorization: Token 3782be88ad71277cad' \
--data '{
"network": "1",
"plan": "2",
"mobile_number": "07012345678"
}'
{
"Status":"successful",
"ident":"202503280837823726ae834d34d",
"network":"1",
"balance_before":"5970.0",
"plan_type":"DATA-SHARE",
"balance_after":"5270.0",
"mobile_number":"07033333333",
"plan":"7",
"api_response":"Dear Customer, You have successfully shared 1GB Data to 2347033333333. Thankyou.",
"plan_network":"MTN",
"plan_name":"1GB (30 Days)",
"plan_amount":"262.0",
"create_date":"2025-03-28 08:37:14"
}
OR
{
"error":[
"You can't purchase this plan due to insufficient balance N109.0. Kindly Fund your Wallet"
]
}
OR
{
"detail":"Authentication credentials were not provided"
}
OR
{
"mobile_number":"This field is required"
}
OR
{
"plan":"This field is required"
}
S/N | Network | Type | Name | Plan Id |
---|---|---|---|---|
1 | AIRTEL | CORPORATE-GIFTING | 500MB (30 Days) | 7 |
2 | AIRTEL | CORPORATE-GIFTING | 1GB (30 Days) | 8 |
3 | AIRTEL | CORPORATE-GIFTING | 2GB (30 Days) | 9 |
4 | AIRTEL | CORPORATE-GIFTING | 5GB (30 Days) | 10 |
5 | AIRTEL | CORPORATE-GIFTING | 10GB (30 Days) | 11 |
6 | AIRTEL | CORPORATE-GIFTING | 15GB (30 Days) | 12 |
7 | AIRTEL | CORPORATE-GIFTING | 20GB (30 Days) | 13 |
8 | AIRTEL | AWOOF-GIFTING | 150MB Daily Plan valid for 1 day | 33 |
9 | AIRTEL | AWOOF-GIFTING | 300MB 2-Days Plan valid for 2 days | 34 |
10 | AIRTEL | AWOOF-GIFTING | 600MB 2-Days Plan valid for 1 day | 35 |
11 | AIRTEL | AWOOF-GIFTING | 1GB 1-Day Plan valid for 1 day | 36 |
12 | AIRTEL | AWOOF-GIFTING | 1.5GB 1-Day Plan valid for 1 day | 37 |
13 | AIRTEL | AWOOF-GIFTING | 2GB 1-Day Plan valid for 1 day | 38 |
14 | AIRTEL | AWOOF-GIFTING | 2GB 5-Days Plan valid for 5 days | 39 |
15 | AIRTEL | AWOOF-GIFTING | 3GB Weekly Plan valid for 7 days | 40 |
16 | AIRTEL | AWOOF-GIFTING | 4GB 2-Days Plan valid for 2 days | 41 |
17 | AIRTEL | AWOOF-GIFTING | 7GB Weekly Plan valid for 7 days | 42 |
18 | AIRTEL | AWOOF-GIFTING | 10GB Monthly Plan valid for 30 days | 43 |
19 | AIRTEL | AWOOF-GIFTING | MIFI 5 - 13GB valid for 30 days | 44 |
20 | AIRTEL | AWOOF-GIFTING | MIFI 10 - 35GB valid for 30 days | 45 |
21 | AIRTEL | AWOOF-GIFTING | MIFI 15 - 60GB valid for 30 days | 46 |
22 | AIRTEL | AWOOF-GIFTING | ROUTER ULTRA 20k - 100GB valid for 30 days | 47 |
23 | GLO | DIRECT-GIFTING | 350MB Night@60 valid for 1 day | 97 |
24 | GLO | CORPORATE-GIFTING | 500MB (30 Days) | 26 |
25 | GLO | CORPORATE-GIFTING | 1GB (30 Days) | 27 |
26 | GLO | CORPORATE-GIFTING | 2GB (30 Days) | 28 |
27 | GLO | CORPORATE-GIFTING | 5GB (30 Days) | 29 |
28 | GLO | CORPORATE-GIFTING | 10GB (30 Days) | 30 |
29 | GLO | AWOOF-GIFTING | 750MB Daily Plan valid for 1 day | 48 |
30 | GLO | AWOOF-GIFTING | 1.5GB Daily Plan valid for 1 day | 49 |
31 | GLO | AWOOF-GIFTING | 2.5GB 2-Days Plan valid for 2 days | 50 |
32 | GLO | AWOOF-GIFTING | 10GB 7-Days Plan valid for 7 days | 51 |
33 | GLO | DIRECT-GIFTING | 750MB Night@120 valid for 1 day | 98 |
34 | GLO | DIRECT-GIFTING | 40MB + 5MB* = 45MB@50 valid for 1 day | 99 |
35 | GLO | DIRECT-GIFTING | 100MB + 5MB* = 105MB@100 valid for 1 day | 100 |
36 | GLO | DIRECT-GIFTING | 210MB + 25MB* = 235MB@200 valid for 2 days | 101 |
37 | GLO | DIRECT-GIFTING | 1GB Night@100 valid for 1 day | 102 |
38 | GLO | DIRECT-GIFTING | 220MB + 40MB* = 260MB@200 valid for 3 days | 103 |
39 | GLO | DIRECT-GIFTING | 875MB@200 valid for 1 day | 104 |
40 | GLO | DIRECT-GIFTING | 1GB SPECIAL@350 valid for 1 day | 105 |
41 | GLO | DIRECT-GIFTING | 2GB SPECIAL@500 valid for 1 day | 106 |
42 | GLO | DIRECT-GIFTING | 3.55GB SPECIAL@600 valid for 1 day | 107 |
43 | GLO | DIRECT-GIFTING | 5.1GB SPECIAL@1000 valid for 2 days | 108 |
44 | GLO | DIRECT-GIFTING | 2.5GB WEEKENDS@500 valid for 2 days | 109 |
45 | GLO | DIRECT-GIFTING | 500MB + 1GB* = 1.5GB@500 valid for 7 days | 110 |
46 | GLO | DIRECT-GIFTING | 1.1GB@750 valid for 14 days | 111 |
47 | GLO | DIRECT-GIFTING | 1.5GB + 2GB* = 3.5GB@1000 valid for 7 days | 112 |
48 | GLO | DIRECT-GIFTING | 6GB + 2.5GB* = 8.5GB@2000 valid for 7 days | 113 |
49 | GLO | DIRECT-GIFTING | 18.5GB + 2GB* = 20.5GB@5000 valid for 7 days | 114 |
50 | GLO | DIRECT-GIFTING | 1.1GB + 1.5GB* = 2.6GB@1000 valid for 30 days | 115 |
51 | GLO | DIRECT-GIFTING | 5.9GB SPECIAL@1500 valid for 7 days | 116 |
52 | GLO | DIRECT-GIFTING | 2GB + 3GB* = 5GB@1500 valid for 30 days | 117 |
53 | GLO | DIRECT-GIFTING | 3.15GB + 3GB* = 6.15GB@2000 valid for 30 days | 118 |
54 | GLO | DIRECT-GIFTING | 4.25GB + 3GB* = 7.25GB@2500 valid for 30 days | 119 |
55 | GLO | DIRECT-GIFTING | 8GB + 2GB* = 10GB@3000 valid for 30 days | 120 |
56 | GLO | DIRECT-GIFTING | 10.5GB + 2GB* = 12.5GB@4000 valid for 30 days | 121 |
57 | GLO | DIRECT-GIFTING | 13.5GB + 2.5GB* = 16GB@5000 valid for 30 days | 122 |
58 | GLO | DIRECT-GIFTING | 18.5GB + 2GB* = 20.5GB@6000 valid for 30 days | 123 |
59 | GLO | DIRECT-GIFTING | 26GB + 2GB* = 28GB@8000 valid for 30 days | 124 |
60 | GLO | DIRECT-GIFTING | 36GB + 2GB* = 38GB@10000 valid for 30 days | 125 |
61 | GLO | DIRECT-GIFTING | 62GB + 2GB* = 64GB@15000 valid for 30 days | 126 |
62 | GLO | DIRECT-GIFTING | 105GB + 2GB* = 107GB@20000 valid for 30 days | 127 |
63 | GLO | DIRECT-GIFTING | 135GB GLOMEGA@25000 valid for 30 days | 128 |
64 | GLO | DIRECT-GIFTING | 165GB GLOMEGA@30000 valid for 30 days | 129 |
65 | GLO | DIRECT-GIFTING | 220GB GLOMEGA@40000 valid for 30 days | 130 |
66 | GLO | DIRECT-GIFTING | 310GB GLOMEGA@50000 valid for 60 days | 131 |
67 | GLO | DIRECT-GIFTING | 380GB GLOMEGA@60000 valid for 90 days | 132 |
68 | GLO | DIRECT-GIFTING | 475GB GLOMEGA@75000 valid for 90 days | 133 |
69 | GLO | DIRECT-GIFTING | 1TB GLOMEGA@150000 valid for 365 days | 134 |
70 | MTN | SME | 500MB (30 Days) | 1 |
71 | MTN | SME | 1GB (30 Days) | 2 |
72 | MTN | SME | 2GB (30 Days) | 3 |
73 | MTN | SME | 3GB (30 Days) | 4 |
74 | MTN | SME | 5GB (30 Days) | 5 |
75 | MTN | SME | 10GB (30 Days) | 6 |
76 | MTN | CORPORATE-GIFTING | 500MB (30 Days) | 16 |
77 | MTN | CORPORATE-GIFTING | 1GB (30 Days) | 17 |
78 | MTN | CORPORATE-GIFTING | 2GB (30 Days) | 18 |
79 | MTN | CORPORATE-GIFTING | 3GB (30 Days) | 19 |
80 | MTN | CORPORATE-GIFTING | 5GB (30 Days) | 20 |
81 | MTN | CORPORATE-GIFTING | 10GB (30 Days) | 21 |
82 | MTN | DATA-SHARE | 1GB (30 Days) | 22 |
83 | MTN | DATA-SHARE | 2GB (30 Days) | 23 |
84 | MTN | DATA-SHARE | 3GB (30 Days) | 24 |
85 | MTN | DATA-SHARE | 5GB (30 Days) | 25 |
86 | MTN | AWOOF-GIFTING | 2.5GB Daily Bundle valid for 1 day | 31 |
87 | MTN | AWOOF-GIFTING | 20GB Weekly Plan valid for 7 days | 32 |
88 | MTN | DIRECT-GIFTING | 75 MB Daily Plan@75 valid for 1 day | 52 |
89 | MTN | DIRECT-GIFTING | 110 MB Daily Plan@100 valid for 1 day | 53 |
90 | MTN | DIRECT-GIFTING | 200MB Social Daily Plan@100 valid for 1 day | 54 |
91 | MTN | DIRECT-GIFTING | 230 MB Daily Plan@200 valid for 1 day | 55 |
92 | MTN | DIRECT-GIFTING | 500MB Daily Plan@350 valid for 1 day | 56 |
93 | MTN | DIRECT-GIFTING | 1GB+1.5mins Daily Plan@500 valid for 1 day | 57 |
94 | MTN | DIRECT-GIFTING | 1.5GB 2 Days Plan@600 valid for 2 days | 58 |
95 | MTN | DIRECT-GIFTING | 2GB 2 Days Plan@750 valid for 2 days | 59 |
96 | MTN | DIRECT-GIFTING | 2.5GB Daily Bundle@750 valid for 1 day | 60 |
97 | MTN | DIRECT-GIFTING | 2.5GB 2-Days Plan@900 valid for 2 days | 61 |
98 | MTN | DIRECT-GIFTING | 750MB + Free 1hr (YouTube/IG/TikTok)@450 valid for 3 days | 62 |
99 | MTN | DIRECT-GIFTING | 3.2GB 2-Day Plan@1000 valid for 2 days | 63 |
100 | MTN | DIRECT-GIFTING | 470MB Social Weekly Plan@200 valid for 7 days | 64 |
101 | MTN | DIRECT-GIFTING | 500MB Weekly Plan@500 valid for 7 days | 65 |
102 | MTN | DIRECT-GIFTING | 1.2GB Pulse Weekly Plan@750 valid for 7 days | 66 |
103 | MTN | DIRECT-GIFTING | 1GB Weekly Plan@800 valid for 7 days | 67 |
104 | MTN | DIRECT-GIFTING | 1.5GB Weekly Plan@1000 valid for 7 days | 68 |
105 | MTN | DIRECT-GIFTING | 3.5GB Weekly Plan@1500 valid for 7 days | 69 |
106 | MTN | DIRECT-GIFTING | 6GB Weekly Plan@2500 valid for 7 days | 70 |
107 | MTN | DIRECT-GIFTING | 11GB Weekly Plan@3500 valid for 7 days | 71 |
108 | MTN | DIRECT-GIFTING | 20GB Weekly Plan@5000 valid for 7 days | 72 |
109 | MTN | DIRECT-GIFTING | 1.2GB Social Monthly Plan@450 valid for 30 days | 73 |
110 | MTN | DIRECT-GIFTING | 2GB+2mins Monthly Plan@1500 valid for 30 days | 74 |
111 | MTN | DIRECT-GIFTING | 2.7GB+2mins Monthly Plan@2000 valid for 30 days | 75 |
112 | MTN | DIRECT-GIFTING | 3.5GB+5mins Monthly Plan@2500 valid for 30 days | 76 |
113 | MTN | DIRECT-GIFTING | 6.75GB Value Data Plan@3000 valid for 30 days | 77 |
114 | MTN | DIRECT-GIFTING | 7GB Monthly Plan@3500 valid for 30 days | 78 |
115 | MTN | DIRECT-GIFTING | 14.5GB Value Data Plan@5000 valid for 30 days | 79 |
116 | MTN | DIRECT-GIFTING | 10GB+10mins Monthly Plan@4500 valid for 30 days | 80 |
117 | MTN | DIRECT-GIFTING | 12.5GB Monthly Plan@5500 valid for 30 days | 81 |
118 | MTN | DIRECT-GIFTING | 16.5GB+10mins Monthly Plan@6500 valid for 30 days | 82 |
119 | MTN | DIRECT-GIFTING | 35GB POSTPAID PLAN@7000 valid for 30 days | 83 |
120 | MTN | DIRECT-GIFTING | 20GB Monthly Plan@7500 valid for 30 days | 84 |
121 | MTN | DIRECT-GIFTING | 25GB Monthly Plan@9000 valid for 30 days | 85 |
122 | MTN | DIRECT-GIFTING | 36GB Monthly Plan@11000 valid for 30 days | 86 |
123 | MTN | DIRECT-GIFTING | 65GB Monthly Plan@16000 valid for 30 days | 87 |
124 | MTN | DIRECT-GIFTING | 75GB Monthly Plan@18000 valid for 30 days | 88 |
125 | MTN | DIRECT-GIFTING | 165GB Monthly Plan@35000 valid for 30 days | 89 |
126 | MTN | DIRECT-GIFTING | 250GB Monthly Plan@55000 valid for 30 days | 90 |
127 | MTN | DIRECT-GIFTING | 40GB Postpaid 2-Month Plan@9000 valid for 60 days | 91 |
128 | MTN | DIRECT-GIFTING | 90GB 2-Month Plan@25000 valid for 60 days | 92 |
129 | MTN | DIRECT-GIFTING | 150GB 2-Month Plan@40000 valid for 60 days | 93 |
130 | MTN | DIRECT-GIFTING | 200GB 2-Month Plan@50000 valid for 60 days | 94 |
131 | MTN | DIRECT-GIFTING | 480GB 3-Month Plan@90000 valid for 90 days | 95 |
132 | MTN | DIRECT-GIFTING | 800GB Yearly Plan@125000 valid for 365 days | 96 |
133 | MTN | DATA-SHARE | 1GB (Weekly) | 135 |
134 | MTN | DATA-SHARE | 2GB (Weekly) | 136 |
135 | MTN | SME | 1GB (Weekly) | 137 |
136 | MTN | SME | 2GB (Weekly) | 138 |