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 1 day35
11AIRTELAWOOF-GIFTING1GB 1-Day Plan valid for 1 day36
12AIRTELAWOOF-GIFTING1.5GB 1-Day Plan valid for 1 day37
13AIRTELAWOOF-GIFTING2GB 1-Day Plan valid for 1 day38
14AIRTELAWOOF-GIFTING2GB 5-Days Plan valid for 5 days39
15AIRTELAWOOF-GIFTING3GB Weekly Plan valid for 7 days40
16AIRTELAWOOF-GIFTING4GB 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-GIFTING100MB 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-GIFTING200MB 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-GIFTING2GB 2 Days (Binge - 2GB + 2GB)@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
93GLODIRECT-GIFTING350MB Night@60 valid for 1 day97
94GLOCORPORATE-GIFTING500MB (30 Days)26
95GLOCORPORATE-GIFTING1GB (30 Days)27
96GLOCORPORATE-GIFTING2GB (30 Days)28
97GLOCORPORATE-GIFTING5GB (30 Days)29
98GLOCORPORATE-GIFTING10GB (30 Days)30
99GLOAWOOF-GIFTING750MB Daily Plan valid for 1 day48
100GLOAWOOF-GIFTING1.5GB Daily Plan valid for 1 day49
101GLOAWOOF-GIFTING2.5GB 2-Days Plan valid for 2 days50
102GLOAWOOF-GIFTING10GB 7-Days Plan valid for 7 days51
103GLODIRECT-GIFTING750MB Night@120 valid for 1 day98
104GLODIRECT-GIFTING40MB + 5MB* = 45MB@50 valid for 1 day99
105GLODIRECT-GIFTING100MB + 5MB* = 105MB@100 valid for 1 day100
106GLODIRECT-GIFTING210MB + 25MB* = 235MB@200 valid for 2 days101
107GLODIRECT-GIFTING1GB Night@100 valid for 1 day102
108GLODIRECT-GIFTING220MB + 40MB* = 260MB@200 valid for 3 days103
109GLODIRECT-GIFTING875MB@200 valid for 1 day104
110GLODIRECT-GIFTING1GB SPECIAL@350 valid for 1 day105
111GLODIRECT-GIFTING2GB SPECIAL@500 valid for 1 day106
112GLODIRECT-GIFTING3.55GB SPECIAL@600 valid for 1 day107
113GLODIRECT-GIFTING5.1GB SPECIAL@1000 valid for 2 days108
114GLODIRECT-GIFTING2.5GB WEEKENDS@500 valid for 2 days109
115GLODIRECT-GIFTING500MB + 1GB* = 1.5GB@500 valid for 7 days110
116GLODIRECT-GIFTING1.1GB@750 valid for 14 days111
117GLODIRECT-GIFTING1.5GB + 2GB* = 3.5GB@1000 valid for 7 days112
118GLODIRECT-GIFTING6GB + 2.5GB* = 8.5GB@2000 valid for 7 days113
119GLODIRECT-GIFTING18.5GB + 2GB* = 20.5GB@5000 valid for 7 days114
120GLODIRECT-GIFTING1.1GB + 1.5GB* = 2.6GB@1000 valid for 30 days115
121GLODIRECT-GIFTING5.9GB SPECIAL@1500 valid for 7 days116
122GLODIRECT-GIFTING2GB + 3GB* = 5GB@1500 valid for 30 days117
123GLODIRECT-GIFTING3.15GB + 3GB* = 6.15GB@2000 valid for 30 days118
124GLODIRECT-GIFTING4.25GB + 3GB* = 7.25GB@2500 valid for 30 days119
125GLODIRECT-GIFTING8GB + 2GB* = 10GB@3000 valid for 30 days120
126GLODIRECT-GIFTING10.5GB + 2GB* = 12.5GB@4000 valid for 30 days121
127GLODIRECT-GIFTING13.5GB + 2.5GB* = 16GB@5000 valid for 30 days122
128GLODIRECT-GIFTING18.5GB + 2GB* = 20.5GB@6000 valid for 30 days123
129GLODIRECT-GIFTING26GB + 2GB* = 28GB@8000 valid for 30 days124
130GLODIRECT-GIFTING36GB + 2GB* = 38GB@10000 valid for 30 days125
131GLODIRECT-GIFTING62GB + 2GB* = 64GB@15000 valid for 30 days126
132GLODIRECT-GIFTING105GB + 2GB* = 107GB@20000 valid for 30 days127
133GLODIRECT-GIFTING135GB GLOMEGA@25000 valid for 30 days128
134GLODIRECT-GIFTING165GB GLOMEGA@30000 valid for 30 days129
135GLODIRECT-GIFTING220GB GLOMEGA@40000 valid for 30 days130
136GLODIRECT-GIFTING310GB GLOMEGA@50000 valid for 60 days131
137GLODIRECT-GIFTING380GB GLOMEGA@60000 valid for 90 days132
138GLODIRECT-GIFTING475GB GLOMEGA@75000 valid for 90 days133
139GLODIRECT-GIFTING1TB GLOMEGA@150000 valid for 365 days134
140GLODIRECT-GIFTING300MB + 1 Hour (My-G Bundle)@100 valid for 1 day140
141GLODIRECT-GIFTING1GB + 1 Hour (My-G Bundle)@300 valid for 3 days141
142GLODIRECT-GIFTING1.5GB + 1 Hour (My-G Bundle)@500 valid for 7 days142
143GLODIRECT-GIFTING3.5GB + 1 Hour (My-G Bundle)@1000 valid for 30 days143
144GLODIRECT-GIFTING6.01GB (Always ON)@2000 valid for 15 days144
145GLODIRECT-GIFTING15GB (Always ON)@3500 valid for 30 days145
146GLODIRECT-GIFTING30GB (Always ON)@5000 valid for 30 days146
147GLODIRECT-GIFTING45GB (Always ON)@7000 valid for 30 days147
148GLODIRECT-GIFTING500MB HOURLY (1-HR)@200 valid for 1 day148
149GLODIRECT-GIFTING1GB HOURLY (2-HRS)@300 valid for 1 day149
150GLODIRECT-GIFTING875MB WEEKENDS@200 valid for 2 days150
151MTNSME500MB (30 Days)1
152MTNSME1GB (30 Days)2
153MTNSME2GB (30 Days)3
154MTNSME3GB (30 Days)4
155MTNSME5GB (30 Days)5
156MTNSME10GB (30 Days)6
157MTNCORPORATE-GIFTING500MB (30 Days)16
158MTNCORPORATE-GIFTING1GB (30 Days)17
159MTNCORPORATE-GIFTING2GB (30 Days)18
160MTNCORPORATE-GIFTING3GB (30 Days)19
161MTNCORPORATE-GIFTING5GB (30 Days)20
162MTNCORPORATE-GIFTING10GB (30 Days)21
163MTNDATA-SHARE1GB (30 Days)22
164MTNDATA-SHARE2GB (30 Days)23
165MTNDATA-SHARE3GB (30 Days)24
166MTNDATA-SHARE5GB (30 Days)25
167MTNAWOOF-GIFTING2.5GB Daily Bundle valid for 1 day31
168MTNAWOOF-GIFTING20GB Weekly Plan valid for 7 days32
169MTNDIRECT-GIFTING75 MB Daily Plan@75 valid for 1 day52
170MTNDIRECT-GIFTING110 MB Daily Plan@100 valid for 1 day53
171MTNDIRECT-GIFTING200MB Social Daily Plan@100 valid for 1 day54
172MTNDIRECT-GIFTING230 MB Daily Plan@200 valid for 1 day55
173MTNDIRECT-GIFTING500MB Daily Plan@350 valid for 1 day56
174MTNDIRECT-GIFTING1GB+1.5mins Daily Plan@500 valid for 1 day57
175MTNDIRECT-GIFTING1.5GB 2 Days Plan@600 valid for 2 days58
176MTNDIRECT-GIFTING2GB 2 Days Plan@750 valid for 2 days59
177MTNDIRECT-GIFTING2.5GB Daily Bundle@750 valid for 1 day60
178MTNDIRECT-GIFTING2.5GB 2-Days Plan@900 valid for 2 days61
179MTNDIRECT-GIFTING750MB + Free 1hr (YouTube/IG/TikTok)@450 valid for 3 days62
180MTNDIRECT-GIFTING3.2GB 2-Day Plan@1000 valid for 2 days63
181MTNDIRECT-GIFTING470MB Social Weekly Plan@200 valid for 7 days64
182MTNDIRECT-GIFTING500MB Weekly Plan@500 valid for 7 days65
183MTNDIRECT-GIFTING1.2GB Pulse Weekly Plan@750 valid for 7 days66
184MTNDIRECT-GIFTING1GB Weekly Plan@800 valid for 7 days67
185MTNDIRECT-GIFTING1.5GB Weekly Plan@1000 valid for 7 days68
186MTNDIRECT-GIFTING3.5GB Weekly Plan@1500 valid for 7 days69
187MTNDIRECT-GIFTING6GB Weekly Plan@2500 valid for 7 days70
188MTNDIRECT-GIFTING11GB Weekly Plan@3500 valid for 7 days71
189MTNDIRECT-GIFTING20GB Weekly Plan@5000 valid for 7 days72
190MTNDIRECT-GIFTING1.2GB Social Monthly Plan@450 valid for 30 days73
191MTNDIRECT-GIFTING2GB+2mins Monthly Plan@1500 valid for 30 days74
192MTNDIRECT-GIFTING2.7GB+2mins Monthly Plan@2000 valid for 30 days75
193MTNDIRECT-GIFTING3.5GB+5mins Monthly Plan@2500 valid for 30 days76
194MTNDIRECT-GIFTING6.75GB Value Data Plan@3000 valid for 30 days77
195MTNDIRECT-GIFTING7GB Monthly Plan@3500 valid for 30 days78
196MTNDIRECT-GIFTING14.5GB Value Data Plan@5000 valid for 30 days79
197MTNDIRECT-GIFTING10GB+10mins Monthly Plan@4500 valid for 30 days80
198MTNDIRECT-GIFTING12.5GB Monthly Plan@5500 valid for 30 days81
199MTNDIRECT-GIFTING16.5GB+10mins Monthly Plan@6500 valid for 30 days82
200MTNDIRECT-GIFTING35GB POSTPAID PLAN@7000 valid for 30 days83
201MTNDIRECT-GIFTING20GB Monthly Plan@7500 valid for 30 days84
202MTNDIRECT-GIFTING25GB Monthly Plan@9000 valid for 30 days85
203MTNDIRECT-GIFTING36GB Monthly Plan@11000 valid for 30 days86
204MTNDIRECT-GIFTING65GB Monthly Plan@16000 valid for 30 days87
205MTNDIRECT-GIFTING75GB Monthly Plan@18000 valid for 30 days88
206MTNDIRECT-GIFTING165GB Monthly Plan@35000 valid for 30 days89
207MTNDIRECT-GIFTING250GB Monthly Plan@55000 valid for 30 days90
208MTNDIRECT-GIFTING40GB Postpaid 2-Month Plan@9000 valid for 60 days91
209MTNDIRECT-GIFTING90GB 2-Month Plan@25000 valid for 60 days92
210MTNDIRECT-GIFTING150GB 2-Month Plan@40000 valid for 60 days93
211MTNDIRECT-GIFTING200GB 2-Month Plan@50000 valid for 60 days94
212MTNDIRECT-GIFTING480GB 3-Month Plan@90000 valid for 90 days95
213MTNDIRECT-GIFTING800GB Yearly Plan@125000 valid for 365 days96
214MTNDATA-SHARE1GB (Weekly)135
215MTNDATA-SHARE2GB (Weekly)136
216MTNSME1GB (Weekly)137
217MTNSME2GB (Weekly)138
218MTNDATA-SHARE500MB (30 Days)139