TopRechargeNG API Documentation

Content

Introduction
API Keys
Fetch Balance
Buy Data

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

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

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)

                
    

    {
        "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	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
137	MTN	DATA-SHARE	500MB (30 Days)	139