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

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
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	GLO	DIRECT-GIFTING	300MB + 1 Hour (My-G Bundle)@100 valid for 1 day	140
71	GLO	DIRECT-GIFTING	1GB + 1 Hour (My-G Bundle)@300 valid for 3 days	141
72	GLO	DIRECT-GIFTING	1.5GB + 1 Hour (My-G Bundle)@500 valid for 7 days	142
73	GLO	DIRECT-GIFTING	3.5GB + 1 Hour (My-G Bundle)@1000 valid for 30 days	143
74	GLO	DIRECT-GIFTING	6.01GB (Always ON)@2000 valid for 15 days	144
75	GLO	DIRECT-GIFTING	15GB (Always ON)@3500 valid for 30 days	145
76	GLO	DIRECT-GIFTING	30GB (Always ON)@5000 valid for 30 days	146
77	GLO	DIRECT-GIFTING	45GB (Always ON)@7000 valid for 30 days	147
78	MTN	SME	500MB (30 Days)	1
79	MTN	SME	1GB (30 Days)	2
80	MTN	SME	2GB (30 Days)	3
81	MTN	SME	3GB (30 Days)	4
82	MTN	SME	5GB (30 Days)	5
83	MTN	SME	10GB (30 Days)	6
84	MTN	CORPORATE-GIFTING	500MB (30 Days)	16
85	MTN	CORPORATE-GIFTING	1GB (30 Days)	17
86	MTN	CORPORATE-GIFTING	2GB (30 Days)	18
87	MTN	CORPORATE-GIFTING	3GB (30 Days)	19
88	MTN	CORPORATE-GIFTING	5GB (30 Days)	20
89	MTN	CORPORATE-GIFTING	10GB (30 Days)	21
90	MTN	DATA-SHARE	1GB (30 Days)	22
91	MTN	DATA-SHARE	2GB (30 Days)	23
92	MTN	DATA-SHARE	3GB (30 Days)	24
93	MTN	DATA-SHARE	5GB (30 Days)	25
94	MTN	AWOOF-GIFTING	2.5GB Daily Bundle valid for 1 day	31
95	MTN	AWOOF-GIFTING	20GB Weekly Plan valid for 7 days	32
96	MTN	DIRECT-GIFTING	75 MB Daily Plan@75 valid for 1 day	52
97	MTN	DIRECT-GIFTING	110 MB Daily Plan@100 valid for 1 day	53
98	MTN	DIRECT-GIFTING	200MB Social Daily Plan@100 valid for 1 day	54
99	MTN	DIRECT-GIFTING	230 MB Daily Plan@200 valid for 1 day	55
100	MTN	DIRECT-GIFTING	500MB Daily Plan@350 valid for 1 day	56
101	MTN	DIRECT-GIFTING	1GB+1.5mins Daily Plan@500 valid for 1 day	57
102	MTN	DIRECT-GIFTING	1.5GB 2 Days Plan@600 valid for 2 days	58
103	MTN	DIRECT-GIFTING	2GB 2 Days Plan@750 valid for 2 days	59
104	MTN	DIRECT-GIFTING	2.5GB Daily Bundle@750 valid for 1 day	60
105	MTN	DIRECT-GIFTING	2.5GB 2-Days Plan@900 valid for 2 days	61
106	MTN	DIRECT-GIFTING	750MB + Free 1hr (YouTube/IG/TikTok)@450 valid for 3 days	62
107	MTN	DIRECT-GIFTING	3.2GB 2-Day Plan@1000 valid for 2 days	63
108	MTN	DIRECT-GIFTING	470MB Social Weekly Plan@200 valid for 7 days	64
109	MTN	DIRECT-GIFTING	500MB Weekly Plan@500 valid for 7 days	65
110	MTN	DIRECT-GIFTING	1.2GB Pulse Weekly Plan@750 valid for 7 days	66
111	MTN	DIRECT-GIFTING	1GB Weekly Plan@800 valid for 7 days	67
112	MTN	DIRECT-GIFTING	1.5GB Weekly Plan@1000 valid for 7 days	68
113	MTN	DIRECT-GIFTING	3.5GB Weekly Plan@1500 valid for 7 days	69
114	MTN	DIRECT-GIFTING	6GB Weekly Plan@2500 valid for 7 days	70
115	MTN	DIRECT-GIFTING	11GB Weekly Plan@3500 valid for 7 days	71
116	MTN	DIRECT-GIFTING	20GB Weekly Plan@5000 valid for 7 days	72
117	MTN	DIRECT-GIFTING	1.2GB Social Monthly Plan@450 valid for 30 days	73
118	MTN	DIRECT-GIFTING	2GB+2mins Monthly Plan@1500 valid for 30 days	74
119	MTN	DIRECT-GIFTING	2.7GB+2mins Monthly Plan@2000 valid for 30 days	75
120	MTN	DIRECT-GIFTING	3.5GB+5mins Monthly Plan@2500 valid for 30 days	76
121	MTN	DIRECT-GIFTING	6.75GB Value Data Plan@3000 valid for 30 days	77
122	MTN	DIRECT-GIFTING	7GB Monthly Plan@3500 valid for 30 days	78
123	MTN	DIRECT-GIFTING	14.5GB Value Data Plan@5000 valid for 30 days	79
124	MTN	DIRECT-GIFTING	10GB+10mins Monthly Plan@4500 valid for 30 days	80
125	MTN	DIRECT-GIFTING	12.5GB Monthly Plan@5500 valid for 30 days	81
126	MTN	DIRECT-GIFTING	16.5GB+10mins Monthly Plan@6500 valid for 30 days	82
127	MTN	DIRECT-GIFTING	35GB POSTPAID PLAN@7000 valid for 30 days	83
128	MTN	DIRECT-GIFTING	20GB Monthly Plan@7500 valid for 30 days	84
129	MTN	DIRECT-GIFTING	25GB Monthly Plan@9000 valid for 30 days	85
130	MTN	DIRECT-GIFTING	36GB Monthly Plan@11000 valid for 30 days	86
131	MTN	DIRECT-GIFTING	65GB Monthly Plan@16000 valid for 30 days	87
132	MTN	DIRECT-GIFTING	75GB Monthly Plan@18000 valid for 30 days	88
133	MTN	DIRECT-GIFTING	165GB Monthly Plan@35000 valid for 30 days	89
134	MTN	DIRECT-GIFTING	250GB Monthly Plan@55000 valid for 30 days	90
135	MTN	DIRECT-GIFTING	40GB Postpaid 2-Month Plan@9000 valid for 60 days	91
136	MTN	DIRECT-GIFTING	90GB 2-Month Plan@25000 valid for 60 days	92
137	MTN	DIRECT-GIFTING	150GB 2-Month Plan@40000 valid for 60 days	93
138	MTN	DIRECT-GIFTING	200GB 2-Month Plan@50000 valid for 60 days	94
139	MTN	DIRECT-GIFTING	480GB 3-Month Plan@90000 valid for 90 days	95
140	MTN	DIRECT-GIFTING	800GB Yearly Plan@125000 valid for 365 days	96
141	MTN	DATA-SHARE	1GB (Weekly)	135
142	MTN	DATA-SHARE	2GB (Weekly)	136
143	MTN	SME	1GB (Weekly)	137
144	MTN	SME	2GB (Weekly)	138
145	MTN	DATA-SHARE	500MB (30 Days)	139