TopRechargeNG API Documentation

Content

Introduction

Our API is a RESTful interface that enables seamless integration of our services into your application.

API Keys

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.

Keys security

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.

API Request

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.

Fetch Balance

Endpoint URL: https://toprechargeng.com/api/user/

Parameters:

Parameter Description

Sample Request Code

                
                
    curl --location 'https://toprechargeng.com/api/user/' \
    --header 'Content-Type: application/json' \
    --header 'authorization: Token 3782be88ad71277cad' \
    --data '{
    
    }'

                
            

Sample Responses Format (JSON)

                
    
    {
        "user": {
            "wallet_balance": 1049.1
        }
    }

                
            

Buy Data

Endpoint URL: https://toprechargeng.com/api/data/

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

Sample Request

                
                
    curl --location 'https://toprechargeng.com/api/data/' \
    --header 'Content-Type: application/json' \
    --header 'authorization: Token 3782be88ad71277cad' \
    --data '{
        "network": "1",
        "plan": "2",
        "mobile_number": "07012345678"
    
    }'

                
            

Sample Responses Format (JSON)

Transactions Statuses: The 'Status' key has 3 possible values: successful, failed & processing. We strongly advise that you only auto-fail transactions that we return as failed.

                
    

    {
        "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"
    }

                
            

Plans

S/N Network Type Name Plan Id
1AIRTELCORPORATE-GIFTING500MB (30 Days)7
2AIRTELCORPORATE-GIFTING1GB (30 Days)8
3AIRTELCORPORATE-GIFTING2GB (30 Days)9
4AIRTELCORPORATE-GIFTING5GB (30 Days)10
5AIRTELCORPORATE-GIFTING10GB (30 Days)11
6AIRTELCORPORATE-GIFTING15GB (30 Days)12
7AIRTELCORPORATE-GIFTING20GB (30 Days)13
8AIRTELAWOOF-GIFTING150MB Daily Plan valid for 1 day33
9AIRTELAWOOF-GIFTING300MB 2-Days Plan valid for 2 days34
10AIRTELAWOOF-GIFTING600MB 2-Days Plan valid for 2 days35
11AIRTELAWOOF-GIFTING1GB 1-Day Plan valid for 1 day36
12AIRTELAWOOF-GIFTING1.5GB 1-Day Plan valid for 1 day37
13AIRTELAWOOF-GIFTING1.5GB 1-Day Plan valid for 1 day38
14AIRTELAWOOF-GIFTING2GB 2-Days Plan valid for 2 days39
15AIRTELAWOOF-GIFTING3GB Weekly Plan valid for 7 days40
16AIRTELAWOOF-GIFTING3GB 2-Days Plan valid for 2 days41
17AIRTELAWOOF-GIFTING7GB Weekly Plan valid for 7 days42
18AIRTELAWOOF-GIFTING10GB Monthly Plan valid for 30 days43
19AIRTELAWOOF-GIFTINGMIFI 5 - 13GB valid for 30 days44
20AIRTELAWOOF-GIFTINGMIFI 10 - 35GB valid for 30 days45
21AIRTELAWOOF-GIFTINGMIFI 15 - 60GB valid for 30 days46
22AIRTELAWOOF-GIFTINGROUTER ULTRA 20k - 100GB valid for 30 days47
23AIRTELDIRECT-GIFTING250MB Night Plan (12 Midnight - 5am)@50 valid for 1 day151
24AIRTELDIRECT-GIFTING75MB Daily@75 valid for 1 day152
25AIRTELDIRECT-GIFTING110MB Daily Plan@100 valid for 1 day153
26AIRTELDIRECT-GIFTING200MB 2-Days Social Plan@100 valid for 2 days154
27AIRTELDIRECT-GIFTING1GB 3-Days Social Plan@300 valid for 3 days155
28AIRTELDIRECT-GIFTING1.5GB 7-Days Social Plan@500 valid for 7 days156
29AIRTELDIRECT-GIFTING230MB 2-Days Plan@200 valid for 2 days157
30AIRTELDIRECT-GIFTING300MB 2-Days Plan@300 valid for 2 days158
31AIRTELDIRECT-GIFTING500MB 1-Day Plan@350 valid for 1 day159
32AIRTELDIRECT-GIFTING1GB 1 Day (Binge - 1GB + 1GB)@500 valid for 1 day160
33AIRTELDIRECT-GIFTING1.5GB 2 Days (Binge)@600 valid for 2 days161
34AIRTELDIRECT-GIFTING3GB 2 Days (Binge - 3GB)@750 valid for 2 days162
35AIRTELDIRECT-GIFTING3GB 2 Days (Binge)@1000 valid for 2 days163
36AIRTELDIRECT-GIFTING3.2GB 2 Days (Binge)@1000 valid for 2 days164
37AIRTELDIRECT-GIFTING500MB Weekly Plan@500 valid for 7 days165
38AIRTELDIRECT-GIFTING1GB Weekly Plan@800 valid for 7 days166
39AIRTELDIRECT-GIFTING1.5GB Weekly Plan@1000 valid for 7 days167
40AIRTELDIRECT-GIFTING3.5GB Weekly Plan@1500 valid for 7 days168
41AIRTELDIRECT-GIFTING6GB Weekly Plan@2500 valid for 7 days169
42AIRTELDIRECT-GIFTING10GB Weekly Plan@3000 valid for 7 days170
43AIRTELDIRECT-GIFTING18GB Weekly Plan@5000 valid for 7 days171
44AIRTELDIRECT-GIFTING5GB 2 Days (Binge)@1500 valid for 2 days172
45AIRTELDIRECT-GIFTINGUnlimited Ultra Router Bundle - 30GB@5000 valid for 7 days173
46AIRTELDIRECT-GIFTING2GB Monthly Plan@1500 valid for 30 days174
47AIRTELDIRECT-GIFTING3GB Monthly Plan@2000 valid for 30 days175
48AIRTELDIRECT-GIFTING4GB Monthly Plan@2500 valid for 30 days176
49AIRTELDIRECT-GIFTING8GB Monthly Plan@3000 valid for 30 days177
50AIRTELDIRECT-GIFTING10GB Monthly Plan@4000 valid for 30 days178
51AIRTELDIRECT-GIFTING13GB Monthly Plan@5000 valid for 30 days179
52AIRTELDIRECT-GIFTING18GB Monthly Plan@6000 valid for 30 days180
53AIRTELDIRECT-GIFTINGAirtel Router Plans 18 GB@5000 valid for 30 days181
54AIRTELDIRECT-GIFTING25GB Monthly Plan@8000 valid for 30 days182
55AIRTELDIRECT-GIFTING35GB Monthly Plan@10000 valid for 30 days183
56AIRTELDIRECT-GIFTINGAirtel Router Plans 40 GB@10000 valid for 30 days184
57AIRTELDIRECT-GIFTINGUltra Plans Router only 40GB + 250MB daily@10000 valid for 30 days185
58AIRTELDIRECT-GIFTING60GB Monthly Plan@15000 valid for 30 days186
59AIRTELDIRECT-GIFTINGUnlimited Ultra Light - 120GB@15000 valid for 30 days187
60AIRTELDIRECT-GIFTINGAirtel Router Plans 75 GB@15000 valid for 30 days188
61AIRTELDIRECT-GIFTINGUltra Plans Router only 75GB + 250MB daily@15000 valid for 30 days189
62AIRTELDIRECT-GIFTINGUltra Plans Mifi 75GB + 250MB daily@15000 valid for 30 days190
63AIRTELDIRECT-GIFTING100GB Monthly Plan@20000 valid for 30 days191
64AIRTELDIRECT-GIFTINGUnlimited 20@30000 valid for 30 days192
65AIRTELDIRECT-GIFTINGAirtel Router Plans 120 GB@20000 valid for 30 days193
66AIRTELDIRECT-GIFTINGUltra Plans Mifi 120GB + 1GBdaily@20000 valid for 30 days194
67AIRTELDIRECT-GIFTINGUltra Plans Router only 120GB + 3GB daily@20000 valid for 30 days195
68AIRTELDIRECT-GIFTINGUnlimited Ultra standard - 200GB@20000 valid for 30 days196
69AIRTELDIRECT-GIFTING160GB Monthly Plan@30000 valid for 30 days197
70AIRTELDIRECT-GIFTINGUnlimited Ultra Diamond - 300GB@30000 valid for 30 days198
71AIRTELDIRECT-GIFTINGUnlimited 40@35000 valid for 30 days199
72AIRTELDIRECT-GIFTING210GB Monthly Plan@40000 valid for 30 days200
73AIRTELDIRECT-GIFTING300GB Quarterly@50000 valid for 90 days201
74AIRTELDIRECT-GIFTINGUnlimited 60@50000 valid for 30 days202
75AIRTELDIRECT-GIFTING350GB 120-Days Plan@60000 valid for 120 days203
76AIRTELDIRECT-GIFTINGUnlimited Ultra Platinum - 550GB@60000 valid for 30 days204
77AIRTELDIRECT-GIFTINGUnlimited 20 90Days@80000 valid for 90 days205
78AIRTELDIRECT-GIFTING685GB Yearly Plan@100000 valid for 365 days206
79AIRTELDIRECT-GIFTINGUnlimited 40 90Days@105000 valid for 90 days207
80AIRTELDIRECT-GIFTINGUnlimited 20 180Days@150000 valid for 180 days208
81AIRTELDIRECT-GIFTINGUnlimited 60 90Days@135000 valid for 90 days209
82AIRTELDIRECT-GIFTINGUnlimited 40 180Days@210000 valid for 180 days210
83AIRTELDIRECT-GIFTINGUnlimited 20 365Days@240000 valid for 365 days211
84AIRTELDIRECT-GIFTINGUnlimited 60 180Days@300000 valid for 180 days212
85AIRTELDIRECT-GIFTINGUnlimited 40 365Days@420000 valid for 365 days213
86AIRTELDIRECT-GIFTINGUnlimited 60 365Days@600000 valid for 365 days214
87AIRTELDIRECT-GIFTINGTalk More N100 - 10 Minutes@100 valid for 3 days215
88AIRTELDIRECT-GIFTINGTalk More N200 - 20 Minutes@200 valid for 7 days216
89AIRTELDIRECT-GIFTINGTalk More N300 - 30 Minutes@300 valid for 7 days217
90AIRTELDIRECT-GIFTINGTalk More N500 - 50 Minutes@500 valid for 14 days218
91AIRTELDIRECT-GIFTINGTalk More N1000 - 100 Minutes@1000 valid for 14 days219
92AIRTELDIRECT-GIFTINGTalk More N1500 - 150 Minutes@1500 valid for 30 days220
93AIRTELAWOOF-GIFTING8GB Monthly Plan valid for 30 days222
94AIRTELAWOOF-GIFTING60GB 2-Month Plan valid for 60 days223
95GLODIRECT-GIFTING350MB Night@60 valid for 1 day97
96GLOCORPORATE-GIFTING500MB (30 Days)26
97GLOCORPORATE-GIFTING1GB (30 Days)27
98GLOCORPORATE-GIFTING2GB (30 Days)28
99GLOCORPORATE-GIFTING5GB (30 Days)29
100GLOCORPORATE-GIFTING10GB (30 Days)30
101GLOAWOOF-GIFTING750MB Daily Plan valid for 1 day48
102GLOAWOOF-GIFTING1.5GB Daily Plan valid for 1 day49
103GLOAWOOF-GIFTING2.5GB 2-Days Plan valid for 2 days50
104GLOAWOOF-GIFTING10GB 7-Days Plan valid for 7 days51
105GLODIRECT-GIFTING750MB Night@120 valid for 1 day98
106GLODIRECT-GIFTING40MB + 5MB* = 45MB@50 valid for 1 day99
107GLODIRECT-GIFTING120MB + 5MB* = 125MB@100 valid for 1 day100
108GLODIRECT-GIFTING250MB + 25MB* = 275MB@200 valid for 2 days101
109GLODIRECT-GIFTING1GB Night@100 valid for 1 day102
110GLODIRECT-GIFTING220MB + 40MB* = 260MB@200 valid for 3 days103
111GLODIRECT-GIFTING875MB@200 valid for 1 day104
112GLODIRECT-GIFTING1GB SPECIAL@350 valid for 1 day105
113GLODIRECT-GIFTING2GB SPECIAL@500 valid for 1 day106
114GLODIRECT-GIFTING3.55GB SPECIAL@600 valid for 1 day107
115GLODIRECT-GIFTING5.1GB SPECIAL@1000 valid for 2 days108
116GLODIRECT-GIFTING2.5GB WEEKENDS@500 valid for 2 days109
117GLODIRECT-GIFTING550MB + 1GB* = 1.55GB@500 valid for 7 days110
118GLODIRECT-GIFTING1.1GB@750 valid for 14 days111
119GLODIRECT-GIFTING1.7GB + 2GB* = 3.7GB@1000 valid for 7 days112
120GLODIRECT-GIFTING6.5GB + 2.5GB* = 9GB@2000 valid for 7 days113
121GLODIRECT-GIFTING22GB + 2.5GB* = 24.5GB@5000 valid for 7 days114
122GLODIRECT-GIFTING1.1GB + 1.5GB* = 2.6GB@1000 valid for 30 days115
123GLODIRECT-GIFTING6GB SPECIAL@1500 valid for 7 days116
124GLODIRECT-GIFTING2.2GB + 3GB* = 5.2GB@1500 valid for 30 days117
125GLODIRECT-GIFTING3.25GB + 3GB* = 6.25GB@2000 valid for 30 days118
126GLODIRECT-GIFTING4.25GB + 3GB* = 7.25GB@2500 valid for 30 days119
127GLODIRECT-GIFTING8.5GB + 2GB* = 10.5GB@3000 valid for 30 days120
128GLODIRECT-GIFTING10.5GB + 2GB* = 12.5GB@4000 valid for 30 days121
129GLODIRECT-GIFTING14.5GB + 2GB* = 16.5GB@5000 valid for 30 days122
130GLODIRECT-GIFTING18.5GB + 2GB* = 20.5GB@6000 valid for 30 days123
131GLODIRECT-GIFTING26GB + 2GB* = 28GB@8000 valid for 30 days124
132GLODIRECT-GIFTING38GB + 4GB* = 42GB@10000 valid for 30 days125
133GLODIRECT-GIFTING62GB + 2GB* = 64GB@15000 valid for 30 days126
134GLODIRECT-GIFTING105GB + 2GB* = 107GB@20000 valid for 30 days127
135GLODIRECT-GIFTING135GB GLOMEGA@25000 valid for 30 days128
136GLODIRECT-GIFTING165GB GLOMEGA@30000 valid for 30 days129
137GLODIRECT-GIFTING220GB GLOMEGA@40000 valid for 30 days130
138GLODIRECT-GIFTING310GB GLOMEGA@50000 valid for 60 days131
139GLODIRECT-GIFTING380GB GLOMEGA@60000 valid for 90 days132
140GLODIRECT-GIFTING475GB GLOMEGA@75000 valid for 90 days133
141GLODIRECT-GIFTING1TB GLOMEGA@150000 valid for 365 days134
142GLODIRECT-GIFTING300MB + 1 Hour (My-G Bundle)@100 valid for 1 day140
143GLODIRECT-GIFTING1GB + 1 Hour (My-G Bundle)@300 valid for 3 days141
144GLODIRECT-GIFTING1.5GB + 1 Hour (My-G Bundle)@500 valid for 7 days142
145GLODIRECT-GIFTING3.5GB + 1 Hour (My-G Bundle)@1000 valid for 30 days143
146GLODIRECT-GIFTING6.01GB (Always ON)@2000 valid for 15 days144
147GLODIRECT-GIFTING15GB (Always ON)@3500 valid for 30 days145
148GLODIRECT-GIFTING30GB (Always ON)@5000 valid for 30 days146
149GLODIRECT-GIFTING45GB (Always ON)@7000 valid for 30 days147
150GLODIRECT-GIFTING500MB HOURLY (1-HR)@200 valid for 1 day148
151GLODIRECT-GIFTING1GB HOURLY (2-HRS)@300 valid for 1 day149
152GLODIRECT-GIFTING875MB WEEKENDS@200 valid for 2 days150
153MTNSME500MB (30 Days)1
154MTNSME1GB (30 Days)2
155MTNSME2GB (30 Days)3
156MTNSME3GB (30 Days)4
157MTNSME5GB (30 Days)5
158MTNSME10GB (30 Days)6
159MTNCORPORATE-GIFTING500MB (30 Days)16
160MTNCORPORATE-GIFTING1GB (30 Days)17
161MTNCORPORATE-GIFTING2GB (30 Days)18
162MTNCORPORATE-GIFTING3GB (30 Days)19
163MTNCORPORATE-GIFTING5GB (30 Days)20
164MTNCORPORATE-GIFTING10GB (30 Days)21
165MTNDATA-SHARE1GB (30 Days)22
166MTNDATA-SHARE2GB (30 Days)23
167MTNDATA-SHARE3GB (30 Days)24
168MTNDATA-SHARE5GB (30 Days)25
169MTNAWOOF-GIFTING2.5GB Daily Bundle valid for 1 day31
170MTNAWOOF-GIFTING20GB Weekly Plan valid for 7 days32
171MTNDIRECT-GIFTING75 MB Daily Plan@75 valid for 1 day52
172MTNDIRECT-GIFTING110 MB Daily Plan@100 valid for 1 day53
173MTNDIRECT-GIFTING200MB Social Daily Plan@100 valid for 1 day54
174MTNDIRECT-GIFTING230 MB Daily Plan@200 valid for 1 day55
175MTNDIRECT-GIFTING500MB Daily Plan@350 valid for 1 day56
176MTNDIRECT-GIFTING1GB+1.5mins Daily Plan@500 valid for 1 day57
177MTNDIRECT-GIFTING1.5GB 2 Days Plan@600 valid for 2 days58
178MTNDIRECT-GIFTING2GB 2 Days Plan@750 valid for 2 days59
179MTNDIRECT-GIFTING2.5GB Daily Bundle@750 valid for 1 day60
180MTNDIRECT-GIFTING2.5GB 2-Days Plan@900 valid for 2 days61
181MTNDIRECT-GIFTING750MB + Free 1hr (YouTube/IG/TikTok)@450 valid for 3 days62
182MTNDIRECT-GIFTING3.2GB 2-Day Plan@1000 valid for 2 days63
183MTNDIRECT-GIFTING470MB Social Weekly Plan@200 valid for 7 days64
184MTNDIRECT-GIFTING500MB Weekly Plan@500 valid for 7 days65
185MTNDIRECT-GIFTING1.2GB Pulse Weekly Plan@750 valid for 7 days66
186MTNDIRECT-GIFTING1GB Weekly Plan@800 valid for 7 days67
187MTNDIRECT-GIFTING1.5GB Weekly Plan@1000 valid for 7 days68
188MTNDIRECT-GIFTING3.5GB Weekly Plan@1500 valid for 7 days69
189MTNDIRECT-GIFTING6GB Weekly Plan@2500 valid for 7 days70
190MTNDIRECT-GIFTING11GB Weekly Plan@3500 valid for 7 days71
191MTNDIRECT-GIFTING20GB Weekly Plan@5000 valid for 7 days72
192MTNDIRECT-GIFTING1.2GB Social Monthly Plan@450 valid for 30 days73
193MTNDIRECT-GIFTING2GB+2mins Monthly Plan@1500 valid for 30 days74
194MTNDIRECT-GIFTING2.7GB+2mins Monthly Plan@2000 valid for 30 days75
195MTNDIRECT-GIFTING3.5GB+5mins Monthly Plan@2500 valid for 30 days76
196MTNDIRECT-GIFTING6.75GB Value Data Plan@3000 valid for 30 days77
197MTNDIRECT-GIFTING7GB Monthly Plan@3500 valid for 30 days78
198MTNDIRECT-GIFTING14.5GB Value Data Plan@5000 valid for 30 days79
199MTNDIRECT-GIFTING10GB+10mins Monthly Plan@4500 valid for 30 days80
200MTNDIRECT-GIFTING12.5GB Monthly Plan@5500 valid for 30 days81
201MTNDIRECT-GIFTING16.5GB+10mins Monthly Plan@6500 valid for 30 days82
202MTNDIRECT-GIFTING35GB POSTPAID PLAN@7000 valid for 30 days83
203MTNDIRECT-GIFTING20GB Monthly Plan@7500 valid for 30 days84
204MTNDIRECT-GIFTING25GB Monthly Plan@9000 valid for 30 days85
205MTNDIRECT-GIFTING36GB Monthly Plan@11000 valid for 30 days86
206MTNDIRECT-GIFTING65GB Monthly Plan@16000 valid for 30 days87
207MTNDIRECT-GIFTING75GB Monthly Plan@18000 valid for 30 days88
208MTNDIRECT-GIFTING165GB Monthly Plan@35000 valid for 30 days89
209MTNDIRECT-GIFTING250GB Monthly Plan@55000 valid for 30 days90
210MTNDIRECT-GIFTING40GB Postpaid 2-Month Plan@9000 valid for 60 days91
211MTNDIRECT-GIFTING90GB 2-Month Plan@25000 valid for 60 days92
212MTNDIRECT-GIFTING150GB 2-Month Plan@40000 valid for 60 days93
213MTNDIRECT-GIFTING200GB 2-Month Plan@50000 valid for 60 days94
214MTNDIRECT-GIFTING480GB 3-Month Plan@90000 valid for 90 days95
215MTNDIRECT-GIFTING800GB Yearly Plan@125000 valid for 365 days96
216MTNDATA-SHARE1GB (Weekly)135
217MTNDATA-SHARE2GB (Weekly)136
218MTNSME1GB (Weekly)137
219MTNSME2GB (Weekly)138
220MTNDATA-SHARE500MB (30 Days)139
221MTNAWOOF-GIFTING1GB Daily Bundle valid for 1 day224