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

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
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
23GLODIRECT-GIFTING350MB Night@60 valid for 1 day97
24GLOCORPORATE-GIFTING500MB (30 Days)26
25GLOCORPORATE-GIFTING1GB (30 Days)27
26GLOCORPORATE-GIFTING2GB (30 Days)28
27GLOCORPORATE-GIFTING5GB (30 Days)29
28GLOCORPORATE-GIFTING10GB (30 Days)30
29GLOAWOOF-GIFTING750MB Daily Plan valid for 1 day48
30GLOAWOOF-GIFTING1.5GB Daily Plan valid for 1 day49
31GLOAWOOF-GIFTING2.5GB 2-Days Plan valid for 2 days50
32GLOAWOOF-GIFTING10GB 7-Days Plan valid for 7 days51
33GLODIRECT-GIFTING750MB Night@120 valid for 1 day98
34GLODIRECT-GIFTING40MB + 5MB* = 45MB@50 valid for 1 day99
35GLODIRECT-GIFTING100MB + 5MB* = 105MB@100 valid for 1 day100
36GLODIRECT-GIFTING210MB + 25MB* = 235MB@200 valid for 2 days101
37GLODIRECT-GIFTING1GB Night@100 valid for 1 day102
38GLODIRECT-GIFTING220MB + 40MB* = 260MB@200 valid for 3 days103
39GLODIRECT-GIFTING875MB@200 valid for 1 day104
40GLODIRECT-GIFTING1GB SPECIAL@350 valid for 1 day105
41GLODIRECT-GIFTING2GB SPECIAL@500 valid for 1 day106
42GLODIRECT-GIFTING3.55GB SPECIAL@600 valid for 1 day107
43GLODIRECT-GIFTING5.1GB SPECIAL@1000 valid for 2 days108
44GLODIRECT-GIFTING2.5GB WEEKENDS@500 valid for 2 days109
45GLODIRECT-GIFTING500MB + 1GB* = 1.5GB@500 valid for 7 days110
46GLODIRECT-GIFTING1.1GB@750 valid for 14 days111
47GLODIRECT-GIFTING1.5GB + 2GB* = 3.5GB@1000 valid for 7 days112
48GLODIRECT-GIFTING6GB + 2.5GB* = 8.5GB@2000 valid for 7 days113
49GLODIRECT-GIFTING18.5GB + 2GB* = 20.5GB@5000 valid for 7 days114
50GLODIRECT-GIFTING1.1GB + 1.5GB* = 2.6GB@1000 valid for 30 days115
51GLODIRECT-GIFTING5.9GB SPECIAL@1500 valid for 7 days116
52GLODIRECT-GIFTING2GB + 3GB* = 5GB@1500 valid for 30 days117
53GLODIRECT-GIFTING3.15GB + 3GB* = 6.15GB@2000 valid for 30 days118
54GLODIRECT-GIFTING4.25GB + 3GB* = 7.25GB@2500 valid for 30 days119
55GLODIRECT-GIFTING8GB + 2GB* = 10GB@3000 valid for 30 days120
56GLODIRECT-GIFTING10.5GB + 2GB* = 12.5GB@4000 valid for 30 days121
57GLODIRECT-GIFTING13.5GB + 2.5GB* = 16GB@5000 valid for 30 days122
58GLODIRECT-GIFTING18.5GB + 2GB* = 20.5GB@6000 valid for 30 days123
59GLODIRECT-GIFTING26GB + 2GB* = 28GB@8000 valid for 30 days124
60GLODIRECT-GIFTING36GB + 2GB* = 38GB@10000 valid for 30 days125
61GLODIRECT-GIFTING62GB + 2GB* = 64GB@15000 valid for 30 days126
62GLODIRECT-GIFTING105GB + 2GB* = 107GB@20000 valid for 30 days127
63GLODIRECT-GIFTING135GB GLOMEGA@25000 valid for 30 days128
64GLODIRECT-GIFTING165GB GLOMEGA@30000 valid for 30 days129
65GLODIRECT-GIFTING220GB GLOMEGA@40000 valid for 30 days130
66GLODIRECT-GIFTING310GB GLOMEGA@50000 valid for 60 days131
67GLODIRECT-GIFTING380GB GLOMEGA@60000 valid for 90 days132
68GLODIRECT-GIFTING475GB GLOMEGA@75000 valid for 90 days133
69GLODIRECT-GIFTING1TB GLOMEGA@150000 valid for 365 days134
70MTNSME500MB (30 Days)1
71MTNSME1GB (30 Days)2
72MTNSME2GB (30 Days)3
73MTNSME3GB (30 Days)4
74MTNSME5GB (30 Days)5
75MTNSME10GB (30 Days)6
76MTNCORPORATE-GIFTING500MB (30 Days)16
77MTNCORPORATE-GIFTING1GB (30 Days)17
78MTNCORPORATE-GIFTING2GB (30 Days)18
79MTNCORPORATE-GIFTING3GB (30 Days)19
80MTNCORPORATE-GIFTING5GB (30 Days)20
81MTNCORPORATE-GIFTING10GB (30 Days)21
82MTNDATA-SHARE1GB (30 Days)22
83MTNDATA-SHARE2GB (30 Days)23
84MTNDATA-SHARE3GB (30 Days)24
85MTNDATA-SHARE5GB (30 Days)25
86MTNAWOOF-GIFTING2.5GB Daily Bundle valid for 1 day31
87MTNAWOOF-GIFTING20GB Weekly Plan valid for 7 days32
88MTNDIRECT-GIFTING75 MB Daily Plan@75 valid for 1 day52
89MTNDIRECT-GIFTING110 MB Daily Plan@100 valid for 1 day53
90MTNDIRECT-GIFTING200MB Social Daily Plan@100 valid for 1 day54
91MTNDIRECT-GIFTING230 MB Daily Plan@200 valid for 1 day55
92MTNDIRECT-GIFTING500MB Daily Plan@350 valid for 1 day56
93MTNDIRECT-GIFTING1GB+1.5mins Daily Plan@500 valid for 1 day57
94MTNDIRECT-GIFTING1.5GB 2 Days Plan@600 valid for 2 days58
95MTNDIRECT-GIFTING2GB 2 Days Plan@750 valid for 2 days59
96MTNDIRECT-GIFTING2.5GB Daily Bundle@750 valid for 1 day60
97MTNDIRECT-GIFTING2.5GB 2-Days Plan@900 valid for 2 days61
98MTNDIRECT-GIFTING750MB + Free 1hr (YouTube/IG/TikTok)@450 valid for 3 days62
99MTNDIRECT-GIFTING3.2GB 2-Day Plan@1000 valid for 2 days63
100MTNDIRECT-GIFTING470MB Social Weekly Plan@200 valid for 7 days64
101MTNDIRECT-GIFTING500MB Weekly Plan@500 valid for 7 days65
102MTNDIRECT-GIFTING1.2GB Pulse Weekly Plan@750 valid for 7 days66
103MTNDIRECT-GIFTING1GB Weekly Plan@800 valid for 7 days67
104MTNDIRECT-GIFTING1.5GB Weekly Plan@1000 valid for 7 days68
105MTNDIRECT-GIFTING3.5GB Weekly Plan@1500 valid for 7 days69
106MTNDIRECT-GIFTING6GB Weekly Plan@2500 valid for 7 days70
107MTNDIRECT-GIFTING11GB Weekly Plan@3500 valid for 7 days71
108MTNDIRECT-GIFTING20GB Weekly Plan@5000 valid for 7 days72
109MTNDIRECT-GIFTING1.2GB Social Monthly Plan@450 valid for 30 days73
110MTNDIRECT-GIFTING2GB+2mins Monthly Plan@1500 valid for 30 days74
111MTNDIRECT-GIFTING2.7GB+2mins Monthly Plan@2000 valid for 30 days75
112MTNDIRECT-GIFTING3.5GB+5mins Monthly Plan@2500 valid for 30 days76
113MTNDIRECT-GIFTING6.75GB Value Data Plan@3000 valid for 30 days77
114MTNDIRECT-GIFTING7GB Monthly Plan@3500 valid for 30 days78
115MTNDIRECT-GIFTING14.5GB Value Data Plan@5000 valid for 30 days79
116MTNDIRECT-GIFTING10GB+10mins Monthly Plan@4500 valid for 30 days80
117MTNDIRECT-GIFTING12.5GB Monthly Plan@5500 valid for 30 days81
118MTNDIRECT-GIFTING16.5GB+10mins Monthly Plan@6500 valid for 30 days82
119MTNDIRECT-GIFTING35GB POSTPAID PLAN@7000 valid for 30 days83
120MTNDIRECT-GIFTING20GB Monthly Plan@7500 valid for 30 days84
121MTNDIRECT-GIFTING25GB Monthly Plan@9000 valid for 30 days85
122MTNDIRECT-GIFTING36GB Monthly Plan@11000 valid for 30 days86
123MTNDIRECT-GIFTING65GB Monthly Plan@16000 valid for 30 days87
124MTNDIRECT-GIFTING75GB Monthly Plan@18000 valid for 30 days88
125MTNDIRECT-GIFTING165GB Monthly Plan@35000 valid for 30 days89
126MTNDIRECT-GIFTING250GB Monthly Plan@55000 valid for 30 days90
127MTNDIRECT-GIFTING40GB Postpaid 2-Month Plan@9000 valid for 60 days91
128MTNDIRECT-GIFTING90GB 2-Month Plan@25000 valid for 60 days92
129MTNDIRECT-GIFTING150GB 2-Month Plan@40000 valid for 60 days93
130MTNDIRECT-GIFTING200GB 2-Month Plan@50000 valid for 60 days94
131MTNDIRECT-GIFTING480GB 3-Month Plan@90000 valid for 90 days95
132MTNDIRECT-GIFTING800GB Yearly Plan@125000 valid for 365 days96
133MTNDATA-SHARE1GB (Weekly)135
134MTNDATA-SHARE2GB (Weekly)136
135MTNSME1GB (Weekly)137
136MTNSME2GB (Weekly)138