TopRechargeNG API Documentation

Content

Introduction
API Keys
Fetch Balance
Fetch Direct Bundles
Buy Data
Buy Airtime

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

Fetch Data Bundles

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

Parameters: To fetch all available bundles, do not perse any parameter.

Parameter	Description
network	This is the networkID. It can be either '1' for MTN, '2' for Glo, '3' for 9mobile or '4' for Airtel
data_type	The type of data to fetch. Available are SME, CORPORATE-GIFTING, AWOOF-GIFTING, DIRECT-GIFTING, DATA-SHARE.

Sample Request

                
                
    curl --location 'https://toprechargeng.com/api/topup/' \
    --header 'Content-Type: application/json' \
    --header 'authorization: Token 3782be88ad71277cad' \
    --data '{
        "network": "1",
        "data_type": "DIRECT-GIFTING"
    
    }'

Sample Responses Format (JSON)

                
    

    {
        "Status": "success",
        "bundles": [
            {
                "Network Name": "MTN",
                "Network ID": "1",
                "Plan Type": "DIRECT-GIFTING",
                "Plan Name": "75 MB Daily Plan@75 valid for 1 day",
                "Plan ID": "52",
                "Network Price": "75.00"
            },
            {
                "Network Name": "MTN",
                "Network ID": "1",
                "Plan Type": "DIRECT-GIFTING",
                "Plan Name": "110 MB Daily Plan@100 valid for 1 day",
                "Plan ID": "53",
                "Network Price": "100.00"
            },
            {
                "Network Name": "MTN",
                "Network ID": "1",
                "Plan Type": "DIRECT-GIFTING",
                "Plan Name": "200MB Social Daily Plan@100 valid for 1 day",
                "Plan ID": "54",
                "Network Price": "100.00"
            },
            {
                "Network Name": "MTN",
                "Network ID": "1",
                "Plan Type": "DIRECT-GIFTING",
                "Plan Name": "230 MB Daily Plan@200 valid for 1 day",
                "Plan ID": "55",
                "Network Price": "200.00"
            },
            {
                "Network Name": "MTN",
                "Network ID": "1",
                "Plan Type": "DIRECT-GIFTING",
                "Plan Name": "500MB Daily Plan@350 valid for 1 day",
                "Plan ID": "56",
                "Network Price": "350.00"
            }
        ]
    }

    OR
    

    {
        "Status": "success",
        "bundles": "No bundles found"
    }

Buy Data

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

Parameters:

Parameter	Description
network	This is the networkID. It can be either '1' for MTN, '2' for Glo, '3' for 9mobile or '4' for Airtel
plan	This is the planID. 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
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	1.5GB 1-Day Plan valid for 1 day	38
11	AIRTEL	AWOOF-GIFTING	2GB 2-Days Plan valid for 2 days	39
12	AIRTEL	AWOOF-GIFTING	3GB 2-Days Plan valid for 2 days	41
13	AIRTEL	AWOOF-GIFTING	10GB Monthly Plan valid for 30 days	43
14	AIRTEL	AWOOF-GIFTING	MIFI 5 - 13GB valid for 30 days	44
15	AIRTEL	AWOOF-GIFTING	MIFI 10 - 35GB valid for 30 days	45
16	AIRTEL	AWOOF-GIFTING	MIFI 15 - 60GB valid for 30 days	46
17	AIRTEL	AWOOF-GIFTING	ROUTER ULTRA 20k - 100GB valid for 30 days	47
18	AIRTEL	DIRECT-GIFTING	250MB Night Plan (12 Midnight - 5am)@50 valid for 1 day	151
19	AIRTEL	DIRECT-GIFTING	75MB Daily@75 valid for 1 day	152
20	AIRTEL	DIRECT-GIFTING	110MB Daily Plan@100 valid for 1 day	153
21	AIRTEL	DIRECT-GIFTING	200MB 2-Days Social Plan@100 valid for 2 days	154
22	AIRTEL	DIRECT-GIFTING	1GB 3-Days Social Plan@300 valid for 3 days	155
23	AIRTEL	DIRECT-GIFTING	1.5GB 7-Days Social Plan@500 valid for 7 days	156
24	AIRTEL	DIRECT-GIFTING	230MB 2-Days Plan@200 valid for 2 days	157
25	AIRTEL	DIRECT-GIFTING	300MB 2-Days Plan@300 valid for 2 days	158
26	AIRTEL	DIRECT-GIFTING	500MB 1-Day Plan@350 valid for 1 day	159
27	AIRTEL	DIRECT-GIFTING	1GB 1 Day (Binge - 1GB + 1GB)@500 valid for 1 day	160
28	AIRTEL	DIRECT-GIFTING	1.5GB 2 Days (Binge)@600 valid for 2 days	161
29	AIRTEL	DIRECT-GIFTING	3GB 2 Days (Binge - 3GB)@750 valid for 2 days	162
30	AIRTEL	DIRECT-GIFTING	3.2GB 2 Days (Binge)@1000 valid for 2 days	164
31	AIRTEL	DIRECT-GIFTING	500MB Weekly Plan@500 valid for 7 days	165
32	AIRTEL	DIRECT-GIFTING	1GB Weekly Plan@800 valid for 7 days	166
33	AIRTEL	DIRECT-GIFTING	1.5GB Weekly Plan@1000 valid for 7 days	167
34	AIRTEL	DIRECT-GIFTING	3.5GB Weekly Plan@1500 valid for 7 days	168
35	AIRTEL	DIRECT-GIFTING	6GB Weekly Plan@2500 valid for 7 days	169
36	AIRTEL	DIRECT-GIFTING	10GB Weekly Plan@3000 valid for 7 days	170
37	AIRTEL	DIRECT-GIFTING	18GB Weekly Plan@5000 valid for 7 days	171
38	AIRTEL	DIRECT-GIFTING	5GB 2 Days (Binge)@1500 valid for 2 days	172
39	AIRTEL	DIRECT-GIFTING	Unlimited Ultra Router Bundle - 30GB@5000 valid for 7 days	173
40	AIRTEL	DIRECT-GIFTING	2GB Monthly Plan@1500 valid for 30 days	174
41	AIRTEL	DIRECT-GIFTING	3GB Monthly Plan@2000 valid for 30 days	175
42	AIRTEL	DIRECT-GIFTING	4GB Monthly Plan@2500 valid for 30 days	176
43	AIRTEL	DIRECT-GIFTING	8GB Monthly Plan@3000 valid for 30 days	177
44	AIRTEL	DIRECT-GIFTING	10GB Monthly Plan@4000 valid for 30 days	178
45	AIRTEL	DIRECT-GIFTING	13GB Monthly Plan@5000 valid for 30 days	179
46	AIRTEL	DIRECT-GIFTING	18GB Monthly Plan@6000 valid for 30 days	180
47	AIRTEL	DIRECT-GIFTING	Airtel Router Plans 18 GB@5000 valid for 30 days	181
48	AIRTEL	DIRECT-GIFTING	25GB Monthly Plan@8000 valid for 30 days	182
49	AIRTEL	DIRECT-GIFTING	35GB Monthly Plan@10000 valid for 30 days	183
50	AIRTEL	DIRECT-GIFTING	Airtel Router Plans 40 GB@10000 valid for 30 days	184
51	AIRTEL	DIRECT-GIFTING	Ultra Plans Router only 40GB + 250MB daily@10000 valid for 30 days	185
52	AIRTEL	DIRECT-GIFTING	60GB Monthly Plan@15000 valid for 30 days	186
53	AIRTEL	DIRECT-GIFTING	Unlimited Ultra Light - 120GB@15000 valid for 30 days	187
54	AIRTEL	DIRECT-GIFTING	Airtel Router Plans 75 GB@15000 valid for 30 days	188
55	AIRTEL	DIRECT-GIFTING	Ultra Plans Router only 75GB + 250MB daily@15000 valid for 30 days	189
56	AIRTEL	DIRECT-GIFTING	Ultra Plans Mifi 75GB + 250MB daily@15000 valid for 30 days	190
57	AIRTEL	DIRECT-GIFTING	100GB Monthly Plan@20000 valid for 30 days	191
58	AIRTEL	DIRECT-GIFTING	Unlimited 20@30000 valid for 30 days	192
59	AIRTEL	DIRECT-GIFTING	Airtel Router Plans 120 GB@20000 valid for 30 days	193
60	AIRTEL	DIRECT-GIFTING	Ultra Plans Mifi 120GB + 1GBdaily@20000 valid for 30 days	194
61	AIRTEL	DIRECT-GIFTING	Ultra Plans Router only 120GB + 3GB daily@20000 valid for 30 days	195
62	AIRTEL	DIRECT-GIFTING	Unlimited Ultra standard - 200GB@20000 valid for 30 days	196
63	AIRTEL	DIRECT-GIFTING	160GB Monthly Plan@30000 valid for 30 days	197
64	AIRTEL	DIRECT-GIFTING	Unlimited Ultra Diamond - 300GB@30000 valid for 30 days	198
65	AIRTEL	DIRECT-GIFTING	Unlimited 40@35000 valid for 30 days	199
66	AIRTEL	DIRECT-GIFTING	210GB Monthly Plan@40000 valid for 30 days	200
67	AIRTEL	DIRECT-GIFTING	300GB Quarterly@50000 valid for 90 days	201
68	AIRTEL	DIRECT-GIFTING	Unlimited 60@50000 valid for 30 days	202
69	AIRTEL	DIRECT-GIFTING	350GB 120-Days Plan@60000 valid for 120 days	203
70	AIRTEL	DIRECT-GIFTING	Unlimited Ultra Platinum - 550GB@60000 valid for 30 days	204
71	AIRTEL	DIRECT-GIFTING	Unlimited 20 90Days@80000 valid for 90 days	205
72	AIRTEL	DIRECT-GIFTING	685GB Yearly Plan@100000 valid for 365 days	206
73	AIRTEL	DIRECT-GIFTING	Unlimited 40 90Days@105000 valid for 90 days	207
74	AIRTEL	DIRECT-GIFTING	Unlimited 20 180Days@150000 valid for 180 days	208
75	AIRTEL	DIRECT-GIFTING	Unlimited 60 90Days@135000 valid for 90 days	209
76	AIRTEL	DIRECT-GIFTING	Unlimited 40 180Days@210000 valid for 180 days	210
77	AIRTEL	DIRECT-GIFTING	Unlimited 20 365Days@240000 valid for 365 days	211
78	AIRTEL	DIRECT-GIFTING	Unlimited 60 180Days@300000 valid for 180 days	212
79	AIRTEL	DIRECT-GIFTING	Unlimited 40 365Days@420000 valid for 365 days	213
80	AIRTEL	DIRECT-GIFTING	Unlimited 60 365Days@600000 valid for 365 days	214
81	AIRTEL	DIRECT-GIFTING	Talk More N100 - 10 Minutes@100 valid for 3 days	215
82	AIRTEL	DIRECT-GIFTING	Talk More N200 - 20 Minutes@200 valid for 7 days	216
83	AIRTEL	DIRECT-GIFTING	Talk More N300 - 30 Minutes@300 valid for 7 days	217
84	AIRTEL	DIRECT-GIFTING	Talk More N500 - 50 Minutes@500 valid for 14 days	218
85	AIRTEL	DIRECT-GIFTING	Talk More N1000 - 100 Minutes@1000 valid for 14 days	219
86	AIRTEL	DIRECT-GIFTING	Talk More N1500 - 150 Minutes@1500 valid for 30 days	220
87	GLO	DIRECT-GIFTING	350MB Night@60 valid for 1 day	97
88	GLO	CORPORATE-GIFTING	500MB (30 Days)	26
89	GLO	CORPORATE-GIFTING	1GB (30 Days)	27
90	GLO	CORPORATE-GIFTING	2GB (30 Days)	28
91	GLO	CORPORATE-GIFTING	5GB (30 Days)	29
92	GLO	CORPORATE-GIFTING	10GB (30 Days)	30
93	GLO	AWOOF-GIFTING	2.5GB 2-Days Plan valid for 2 days	50
94	GLO	AWOOF-GIFTING	10GB 7-Days Plan valid for 7 days	51
95	GLO	DIRECT-GIFTING	750MB Night@120 valid for 1 day	98
96	GLO	DIRECT-GIFTING	40MB + 5MB* = 45MB@50 valid for 1 day	99
97	GLO	DIRECT-GIFTING	120MB + 5MB* = 125MB@100 valid for 1 day	100
98	GLO	DIRECT-GIFTING	250MB + 25MB* = 275MB@200 valid for 2 days	101
99	GLO	DIRECT-GIFTING	220MB + 40MB* = 260MB@200 valid for 3 days	103
100	GLO	DIRECT-GIFTING	875MB@200 valid for 1 day	104
101	GLO	DIRECT-GIFTING	1GB SPECIAL@350 valid for 1 day	105
102	GLO	DIRECT-GIFTING	2GB SPECIAL@500 valid for 1 day	106
103	GLO	DIRECT-GIFTING	3.55GB SPECIAL@600 valid for 1 day	107
104	GLO	DIRECT-GIFTING	5.1GB SPECIAL@1000 valid for 2 days	108
105	GLO	DIRECT-GIFTING	2.5GB WEEKENDS@500 valid for 2 days	109
106	GLO	DIRECT-GIFTING	550MB + 1GB* = 1.55GB@500 valid for 7 days	110
107	GLO	DIRECT-GIFTING	1.1GB@750 valid for 14 days	111
108	GLO	DIRECT-GIFTING	1.7GB + 2GB* = 3.7GB@1000 valid for 7 days	112
109	GLO	DIRECT-GIFTING	6.5GB + 2.5GB* = 9GB@2000 valid for 7 days	113
110	GLO	DIRECT-GIFTING	22GB + 2.5GB* = 24.5GB@5000 valid for 7 days	114
111	GLO	DIRECT-GIFTING	1.1GB + 1.5GB* = 2.6GB@1000 valid for 30 days	115
112	GLO	DIRECT-GIFTING	6GB SPECIAL@1500 valid for 7 days	116
113	GLO	DIRECT-GIFTING	2.2GB + 3GB* = 5.2GB@1500 valid for 30 days	117
114	GLO	DIRECT-GIFTING	3.25GB + 3GB* = 6.25GB@2000 valid for 30 days	118
115	GLO	DIRECT-GIFTING	4.25GB + 3GB* = 7.25GB@2500 valid for 30 days	119
116	GLO	DIRECT-GIFTING	8.5GB + 2GB* = 10.5GB@3000 valid for 30 days	120
117	GLO	DIRECT-GIFTING	10.5GB + 2GB* = 12.5GB@4000 valid for 30 days	121
118	GLO	DIRECT-GIFTING	14.5GB + 2GB* = 16.5GB@5000 valid for 30 days	122
119	GLO	DIRECT-GIFTING	18.5GB + 2GB* = 20.5GB@6000 valid for 30 days	123
120	GLO	DIRECT-GIFTING	26GB + 2GB* = 28GB@8000 valid for 30 days	124
121	GLO	DIRECT-GIFTING	38GB + 4GB* = 42GB@10000 valid for 30 days	125
122	GLO	DIRECT-GIFTING	62GB + 2GB* = 64GB@15000 valid for 30 days	126
123	GLO	DIRECT-GIFTING	105GB + 2GB* = 107GB@20000 valid for 30 days	127
124	GLO	DIRECT-GIFTING	135GB GLOMEGA@25000 valid for 30 days	128
125	GLO	DIRECT-GIFTING	165GB GLOMEGA@30000 valid for 30 days	129
126	GLO	DIRECT-GIFTING	220GB GLOMEGA@40000 valid for 30 days	130
127	GLO	DIRECT-GIFTING	310GB GLOMEGA@50000 valid for 60 days	131
128	GLO	DIRECT-GIFTING	380GB GLOMEGA@60000 valid for 90 days	132
129	GLO	DIRECT-GIFTING	475GB GLOMEGA@75000 valid for 90 days	133
130	GLO	DIRECT-GIFTING	1TB GLOMEGA@150000 valid for 365 days	134
131	GLO	DIRECT-GIFTING	300MB + 1 Hour (My-G Bundle)@100 valid for 1 day	140
132	GLO	DIRECT-GIFTING	1GB + 1 Hour (My-G Bundle)@300 valid for 3 days	141
133	GLO	DIRECT-GIFTING	1.5GB + 1 Hour (My-G Bundle)@500 valid for 7 days	142
134	GLO	DIRECT-GIFTING	3.5GB + 1 Hour (My-G Bundle)@1000 valid for 30 days	143
135	GLO	DIRECT-GIFTING	6.01GB (Always ON)@2000 valid for 15 days	144
136	GLO	DIRECT-GIFTING	15GB (Always ON)@3500 valid for 30 days	145
137	GLO	DIRECT-GIFTING	30GB (Always ON)@5000 valid for 30 days	146
138	GLO	DIRECT-GIFTING	45GB (Always ON)@7000 valid for 30 days	147
139	GLO	DIRECT-GIFTING	500MB HOURLY (1-HR)@200 valid for 1 day	148
140	GLO	DIRECT-GIFTING	1GB HOURLY (2-HRS)@300 valid for 1 day	149
141	GLO	DIRECT-GIFTING	875MB WEEKENDS@200 valid for 2 days	150
142	MTN	SME	500MB (30 Days)	1
143	MTN	SME	1GB (30 Days)	2
144	MTN	SME	2GB (30 Days)	3
145	MTN	SME	3GB (30 Days)	4
146	MTN	SME	5GB (30 Days)	5
147	MTN	SME	10GB (30 Days)	6
148	MTN	CORPORATE-GIFTING	500MB (30 Days)	16
149	MTN	CORPORATE-GIFTING	1GB (30 Days)	17
150	MTN	CORPORATE-GIFTING	2GB (30 Days)	18
151	MTN	CORPORATE-GIFTING	3GB (30 Days)	19
152	MTN	CORPORATE-GIFTING	5GB (30 Days)	20
153	MTN	CORPORATE-GIFTING	10GB (30 Days)	21
154	MTN	DATA-SHARE	1GB (30 Days)	22
155	MTN	DATA-SHARE	2GB (30 Days)	23
156	MTN	DATA-SHARE	3GB (30 Days)	24
157	MTN	DATA-SHARE	5GB (30 Days)	25
158	MTN	DIRECT-GIFTING	75 MB Daily Plan@75 valid for 1 day	52
159	MTN	DIRECT-GIFTING	110 MB Daily Plan@100 valid for 1 day	53
160	MTN	DIRECT-GIFTING	200MB Social Daily Plan@100 valid for 1 day	54
161	MTN	DIRECT-GIFTING	230 MB Daily Plan@200 valid for 1 day	55
162	MTN	DIRECT-GIFTING	500MB Daily Plan@350 valid for 1 day	56
163	MTN	DIRECT-GIFTING	1GB+1.5mins Daily Plan@500 valid for 1 day	57
164	MTN	DIRECT-GIFTING	1.5GB 2 Days Plan@600 valid for 2 days	58
165	MTN	DIRECT-GIFTING	2GB 2 Days Plan@750 valid for 2 days	59
166	MTN	DIRECT-GIFTING	2.5GB Daily Bundle@750 valid for 1 day	60
167	MTN	DIRECT-GIFTING	2.5GB 2-Days Plan@900 valid for 2 days	61
168	MTN	DIRECT-GIFTING	750MB + Free 1hr (YouTube/IG/TikTok)@450 valid for 3 days	62
169	MTN	DIRECT-GIFTING	3.2GB 2-Day Plan@1000 valid for 2 days	63
170	MTN	DIRECT-GIFTING	470MB Social Weekly Plan@200 valid for 7 days	64
171	MTN	DIRECT-GIFTING	500MB Weekly Plan@500 valid for 7 days	65
172	MTN	DIRECT-GIFTING	1.2GB Pulse Weekly Plan@750 valid for 7 days	66
173	MTN	DIRECT-GIFTING	1GB Weekly Plan@800 valid for 7 days	67
174	MTN	DIRECT-GIFTING	1.5GB Weekly Plan@1000 valid for 7 days	68
175	MTN	DIRECT-GIFTING	3.5GB Weekly Plan@1500 valid for 7 days	69
176	MTN	DIRECT-GIFTING	6GB Weekly Plan@2500 valid for 7 days	70
177	MTN	DIRECT-GIFTING	11GB Weekly Plan@3500 valid for 7 days	71
178	MTN	DIRECT-GIFTING	20GB Weekly Plan@5000 valid for 7 days	72
179	MTN	DIRECT-GIFTING	1.2GB Social Monthly Plan@450 valid for 30 days	73
180	MTN	DIRECT-GIFTING	2GB+2mins Monthly Plan@1500 valid for 30 days	74
181	MTN	DIRECT-GIFTING	2.7GB+2mins Monthly Plan@2000 valid for 30 days	75
182	MTN	DIRECT-GIFTING	3.5GB+5mins Monthly Plan@2500 valid for 30 days	76
183	MTN	DIRECT-GIFTING	6.75GB Value Data Plan@3000 valid for 30 days	77
184	MTN	DIRECT-GIFTING	7GB Monthly Plan@3500 valid for 30 days	78
185	MTN	DIRECT-GIFTING	14.5GB Value Data Plan@5000 valid for 30 days	79
186	MTN	DIRECT-GIFTING	10GB+10mins Monthly Plan@4500 valid for 30 days	80
187	MTN	DIRECT-GIFTING	12.5GB Monthly Plan@5500 valid for 30 days	81
188	MTN	DIRECT-GIFTING	16.5GB+10mins Monthly Plan@6500 valid for 30 days	82
189	MTN	DIRECT-GIFTING	35GB POSTPAID PLAN@7000 valid for 30 days	83
190	MTN	DIRECT-GIFTING	20GB Monthly Plan@7500 valid for 30 days	84
191	MTN	DIRECT-GIFTING	25GB Monthly Plan@9000 valid for 30 days	85
192	MTN	DIRECT-GIFTING	36GB Monthly Plan@11000 valid for 30 days	86
193	MTN	DIRECT-GIFTING	65GB Monthly Plan@16000 valid for 30 days	87
194	MTN	DIRECT-GIFTING	75GB Monthly Plan@18000 valid for 30 days	88
195	MTN	DIRECT-GIFTING	165GB Monthly Plan@35000 valid for 30 days	89
196	MTN	DIRECT-GIFTING	250GB Monthly Plan@55000 valid for 30 days	90
197	MTN	DIRECT-GIFTING	40GB Postpaid 2-Month Plan@9000 valid for 60 days	91
198	MTN	DIRECT-GIFTING	90GB 2-Month Plan@25000 valid for 60 days	92
199	MTN	DIRECT-GIFTING	150GB 2-Month Plan@40000 valid for 60 days	93
200	MTN	DIRECT-GIFTING	200GB 2-Month Plan@50000 valid for 60 days	94
201	MTN	DIRECT-GIFTING	480GB 3-Month Plan@90000 valid for 90 days	95
202	MTN	DIRECT-GIFTING	800GB Yearly Plan@125000 valid for 365 days	96
203	MTN	DATA-SHARE	1GB (Weekly)	135
204	MTN	SME	1GB (Weekly)	137
205	MTN	DATA-SHARE	500MB (30 Days)	139
206	MTN	AWOOF-GIFTING	1GB Daily Bundle valid for 1 day	224
207	MTN	AWOOF-GIFTING	1GB valid for 30 days	229
208	MTN	AWOOF-GIFTING	2GB valid for 30 days	230
209	MTN	AWOOF-GIFTING	3GB valid for 30 days	231
210	MTN	AWOOF-GIFTING	5GB valid for 30 days	232
211	MTN	AWOOF-GIFTING	2GB Daily Bundle valid for 1 day	233
212	MTN	SME	15GB (30 Days)	237
213	MTN	SME	20GB (30 Days)	238
214	MTN	DATA-SHARE	10GB (30 Days)	240
215	MTN	DATA-SHARE	15GB (30 Days)	241
216	MTN	DATA-SHARE	20GB (30 Days)	242

Buy Airtime

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

Parameters:

Parameter	Description
network	This is the networkID. It can be either '1' for MTN, '2' for Glo, '3' for 9mobile or '4' for Airtel
amount	The amount to purchase. Minimum amount is N50.
mobile_number	Beneficiary phone number
airtime_type	VTU

Sample Request

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

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",
        "airtime_type": "VTU",
        "ident": "2026051312296a04609016579",
        "network": "mtn",
        "paid_amount": "49.0",
        "balance_before": "73.4",
        "balance_after": "24.4",
        "mobile_number": "07033333333",
        "plan_network": "MTN",
        "amount": 50,
        "api_response": "You have successfully recharge N50 to 0703****333.",
        "plan_amount": "N50",
        "create_date": "2026-05-13 12:29:20"
    }

    OR
    

    {
        "error": [
            "You can't topup due to insufficient balance  N73.40 "
        ]
    }
    
    OR
    
    {
        "error": [
            "Please check entered number is not MTN user 07012345678!"
        ]
    }


    OR

    {
        "detail":"Authentication credentials were not provided"
    }


    OR


    {
        "mobile_number":"This field is required"
    }


    OR

    {
        "amount":"This field is required"
    }


    OR

    {
        "airtime_type":"This field is required"
    }
    
    OR
    
    
    {
        "Status": "failed",
        "airtime_type": "VTU",
        "ident": "2026051312126a045c9c6618a",
        "network": "mtn",
        "paid_amount": "0.0",
        "balance_before": "73.4",
        "balance_after": "73.4",
        "mobile_number": "0701234567",
        "plan_network": "MTN",
        "amount": 50,
        "api_response": "Phone number must start with \"0\" and must be 11 characters",
        "plan_amount": "N50",
        "create_date": "2026-05-13 12:12:28"
    }