Arewa Global API Documentation

Welcome to the API documentation for Arewaglobal.co. This document provides detailed information about the endpoints, request/response formats, and authentication mechanisms for accessing the API.

Your API TOKEN:

Login into the webiste and click on profile to get your APIKEY

Base URL

All API endpoints are relative to the following base URL:

https://arewaglobal.co

Authentication

Add the following header to authenticate API requests:

Authorization: Token <your_api_key>

Endpoints

1. User Details

Endpoint URL

POST /api/user/

Description

This endpoint allows you to retrieve your user details.

Request

• Method: POST
• Headers:
  • Authorization: Token <your_api_key>

Response

• Status: 200 OK
• Body: JSON object representing the response data.

{
  "status": "success",
  "name": "Your Full Name",
  "balance": "Your Wallet Balance"
}

2. Buy Data

Endpoint URL

POST /api/data/

Description

This endpoint allows you to purchase data.

Request

• Method: POST
• Headers:
  • Authorization: Token <your_api_key>
• Body: JSON object containing the following:

{
  "phone": "08066652565",
  "plan": "22",     // Plan ID
  "network": "1",   // Network ID  MTN =1, AIRTEL = 2, GLO = 3, 9MOBILE=4.
  "ported_number": "true or false"
}

Response

• Status: 201 Created
• Body: JSON object representing the purchase result.

{
  "status": "success",
  "msg": "You have purchased MTN SME 1GB for N219 to 08065265856"
}

Data Plans

Plan ID	Plan Name	Price (₦)	Agent (₦)	Vendor (₦)	Validity
409	MTN SME ( 5.0GB )	₦3500	₦3500	₦3500	30 Days
284	MTN SME ( 3.0GB )	₦2100	₦2100	₦2100	30 Days
283	MTN SME ( 2.0GB )	₦1400	₦1400	₦1400	30 Days
282	MTN SME ( 1.0GB )	₦700	₦700	₦700	30 Days
393	MTN MTN ( 16.5GB+10mins)	₦6500	₦6500	₦6500	30 Days
403	MTN GIFTING ( 90GB )	₦25000	₦25000	₦25000	30 Days
397	MTN GIFTING ( 7GB )	₦3500	₦3500	₦3500	30 Days
260	MTN GIFTING ( 75MB)	₦80	₦80	₦80	1 Days
402	MTN GIFTING ( 75GB )	₦18000	₦18000	₦18000	30 Days
390	MTN GIFTING ( 6GB )	₦2500	₦2500	₦2500	7 Days
401	MTN GIFTING ( 65GB )	₦16000	₦16000	₦16000	30 Days
391	MTN GIFTING ( 5.5GB )	₦3000	₦3000	₦3000	30 Days
400	MTN GIFTING ( 36GB )	₦11000	₦11000	₦11000	30 Days
398	MTN GIFTING ( 35GB )	₦7000	₦7000	₦7000	30 Days
399	MTN GIFTING ( 25GB )	₦9000	₦9000	₦9000	30 Days
395	MTN GIFTING ( 14.5GB )	₦5000	₦5000	₦5000	30 Days
394	MTN GIFTING ( 11GB )	₦3500	₦3500	₦3500	7 Days
381	MTN GIFTING ( 600MB)	₦550	₦550	₦550	7 Days
377	MTN GIFTING ( 500MB)	₦350	₦350	₦350	1 Days
379	MTN GIFTING ( 500MB)	₦500	₦500	₦500	7 Days
374	MTN GIFTING ( 470MB ) social plan	₦210	₦210	₦210	7 Days
388	MTN GIFTING ( 3.5GB )	₦1500	₦1500	₦1500	7 Days
387	MTN GIFTING ( 3.2GB )	₦1000	₦1000	₦1000	2 Days
383	MTN GIFTING ( 2GB )	₦750	₦750	₦750	2 Days
376	MTN GIFTING ( 230MB)	₦210	₦210	₦210	1 Days
375	MTN GIFTING ( 200MB) social plan	₦120	₦120	₦120	1 Days
385	MTN GIFTING ( 2.5GB )	₦900	₦900	₦900	2 Days
380	MTN GIFTING ( 1GB+1.5mins)	₦500	₦500	₦500	1 Days
384	MTN GIFTING ( 1GB )	₦800	₦800	₦800	7 Days
382	MTN GIFTING ( 1.5GB )	₦600	₦600	₦600	2 Days
386	MTN GIFTING ( 1.5GB )	₦1000	₦1000	₦1000	7 Days
378	MTN GIFTING ( 1.2GB) social plan	₦450	₦450	₦450	30 Days
389	MTN GIFTING ( 1.8GB )	₦1500	₦1500	₦1500	30 Days
373	MTN DIRECT 1.8GB + 35mnt of call + 150 Bulk SMS	₦1550	₦1550	₦1550	30 Days
372	MTN DATA (10GB + 10mins )	₦4500	₦4500	₦4500	30 Days
368	MTN DATA ( 3.5GB+5mins )	₦2500	₦2500	₦2500	30 Days
367	MTN DATA ( 2.7GB+2mins )	₦2000	₦2000	₦2000	30 Days
366	MTN DATA ( 2GB+2mins )	₦1600	₦1600	₦1600	30 Days
356	GLO GIFTING 🎁 5.1GB SPECIAL	₦1000	₦1000	₦1000	2 Days
358	GLO GIFTING 🎁 3.5GB	₦1000	₦1000	₦1000	7 Days
355	GLO GIFTING 🎁 3.55GB SPECIAL	₦600	₦600	₦600	1 Days
354	GLO GIFTING 🎁 2 GB SPECIAL	₦500	₦500	₦500	1 Days
357	GLO GIFTING 🎁 1.1GB	₦750	₦750	₦750	14 Days
346	GLO GIFTING 🎁 750MB Night	₦125	₦125	₦125	1 Days
345	GLO GIFTING 🎁 750MB	₦210	₦200	₦210	1 Days
344	GLO GIFTING 🎁 45MB	₦53	₦53	₦53	1 Days
348	GLO GIFTING 🎁 235MB	₦220	₦220	₦220	2 Days
351	GLO GIFTING 🎁 2.5GB	₦535	₦535	₦535	2 Days
353	GLO GIFTING 🎁 1GB SPECIAL	₦350	₦350	₦350	1 Days
349	GLO GIFTING 🎁 1GB Night	₦120	₦120	₦120	1 Days
352	GLO GIFTING 🎁 10GB	₦2000	₦2000	₦2000	7 Days
347	GLO GIFTING 🎁 105MB	₦110	₦110	₦110	1 Days
350	GLO GIFTING 🎁 1.5GB	₦320	₦320	₦320	1 Days
140	GlO CG 500MB	₦230	₦230	₦230	30 Days
158	GLO CG 3.072GB	₦1350	₦1350	₦1350	30 Days
157	GLO CG 2GB	₦900	₦900	₦900	30 Days
124	GLO CG 200MB	₦100	₦100	₦100	14 Days
141	GlO CG 1.024GB	₦450	₦450	₦450	30 Days
159	GLO CG 5.12GB	₦2250	₦2250	₦2250	30 Days
331	Get Voice minutes - 50 Minutes	₦500	₦500	₦500	14 Days
330	Get Voice minutes - 30 Minutes	₦300	₦300	₦300	7 Days
329	Get Voice minutes - 20 Minutes	₦200	₦200	₦200	7 Days
333	Get Voice minutes - 150 Minutes	₦1500	₦1500	₦1500	30 Days
332	Get Voice minutes - 100 Minutes	₦1000	₦1000	₦1000	14 Days
328	Get Voice minutes - 10 Minutes	₦100	₦100	₦100	3 Days
360	AIRTEL SME SPECIAL ( 3.50GB )	₦1550	₦1550	₦1550	7 Days
362	AIRTEL SME SPECIAL ( 1.50GB )	₦430	₦430	₦430	1 Days
361	AIRTEL SME SPECIAL ( 4.0GB )	₦770	₦770	₦770	2 Days
359	AIRTEL SME SPECIAL ( 1.0GB )	₦400	₦400	₦400	1 Days
306	AIRTEL SME 🎁 ( 3.0GB )	₦1100	₦1100	₦1050	2 Days
410	AIRTEL SME 🎁 ( 150MB )	₦75	₦75	₦75	1 Days
412	AIRTEL SME 🎁 ( 600MB )	₦250	₦250	₦250	2 Days
411	AIRTEL SME 🎁 ( 300MB )	₦180	₦180	₦180	2 Days
308	AIRTEL SME ( 10.0GB )	₦3200	₦3200	₦3100	30 Days
305	AIRTEL SME ( 2.0GB )	₦650	₦650	₦600	5 Days
304	AIRTEL SME ( 1.0GB )	₦380	₦380	₦350	3 Days
307	AIRTEL SME ( 7.0GB )	₦2100	₦2100	₦2050	7 Days
341	AIRTEL SME ( 13.0GB )	₦5200	₦5200	₦5150	30 Days
325	Airtel GIFTING 🎁 ( 4.0GB )	₦2500	₦2500	₦2500	30 Days
321	Airtel GIFTING 🎁 ( 6.0 GB )	₦2500	₦2500	₦2500	7 Days
326	Airtel GIFTING 🎁 ( 8.0GB )	₦3000	₦3000	₦3000	30 Days
309	Airtel GIFTING 🎁 ( 75MB )	₦85	₦85	₦85	1 Days
320	Airtel GIFTING 🎁 ( 3.5GB )	₦1500	₦1500	₦1500	7 Days
316	Airtel GIFTING 3.0GB	₦2000	₦2000	₦2000	30 Days
324	Airtel GIFTING 3.0GB	₦2000	₦2000	₦2000	30 Days
312	Airtel GIFTING 200MB	₦325	₦325	₦325	2 Days
315	Airtel GIFTING 2.0GB	₦800	₦800	₦800	2 Days
323	Airtel GIFTING 18.0GB	₦5000	₦5000	₦5000	7 Days
310	Airtel GIFTING 100MB	₦115	₦115	₦115	1 Days
322	Airtel GIFTING 10.0GB	₦3000	₦3000	₦3000	7 Days
314	Airtel GIFTING 1.5GB	₦610	₦610	₦610	2 Days
319	Airtel GIFTING 1.5GB	₦1000	₦1000	₦1000	7 Days
313	Airtel GIFTING 1.0GB	₦510	₦510	₦510	1 Days
318	Airtel GIFTING 1.0GB	₦800	₦800	₦800	7 Days
317	Airtel GIFTING 🎁 ( 500MB )	₦500	₦510	₦500	7 Days
134	9MOBILE 5GB	₦1500	₦1500	₦1500	30 Days
129	9MOBILE 500MB	₦150	₦150	₦150	30 Days
133	9MOBILE 3GB	₦900	₦900	₦900	30 Days
132	9MOBILE 2GB	₦600	₦600	₦600	30 Days
130	9MOBILE 1GB	₦300	₦300	₦300	30 Days
131	9MOBILE 1.5GB	₦430	₦430	₦430	30 Days

3. Buy Airtime

Endpoint URL

POST /api/airtime/

Description

This endpoint allows you to purchase airtime.

Request

• Method: POST
• Headers:
  • Authorization: Token <your_api_key>
• Body: JSON object containing the following:

{
  "phone": "08066652565",
  "amount": "100",  // Amount to buy
  "network": "1",   // Network ID (MTN=1, AIRTEL=2, GLO=3, 9MOBILE=4)
  "ported_number": "true or false"
}

Response

• Status: 201 Created
• Body: JSON object representing the purchase result.

{
  "status": "success",
  "msg": "You have topped up 08065265856 with MTN airtime for N100"
}

4. Buy Smile Bundle

Endpoint URL

POST /api/smile-data/

Description

This endpoint allows you to purchase Smile bundles.

Request

• Method: POST
• Headers:
  • Authorization: Token <your_api_key>
• Body: JSON object containing the following:

{
  "PhoneNumber": "2347056525656",
  "BundleTypeCode": "321",   // Bundle Code
  "actype": "AccountNumber"  // Account type
}

Response

• Status: 201 Created
• Body: JSON object representing the purchase result.

{
  "status": "success",
  "service": "Smile Bundle",
  "msg": "You have successfully purchased 165 Smile minutes"
}

Smile BundleCode

Bundle Code	Plan Name	Price (₦)	Validity
11	SmileVoice ONLY 65	₦900.0	30 days
12	SmileVoice ONLY 135	₦1850.0	30 days
13	SmileVoice ONLY 430	₦5700.0	30 days
14	SmileVoice ONLY 450	₦7200.0	60 days
15	SmileVoice ONLY 500	₦9000.0	90 days
16	1GB flexidaily	₦450.0	1 day
17	2.5GB FlexiDaily	₦750.0	2 days
18	1GB flexiweekly	₦750.0	7 days
19	SmileVoice ONLY 150	₦2700.0	60 days
20	SmileVoice ONLY 175	₦3600.0	90 days
21	2GB FlexiWeekly	₦1550.0	7 days
25	1.5GB Bigga	₦1550.0	30 days
26	2GB Bigga	₦1800.0	30 days
27	3GB Bigga	₦2300.0	30 days
28	5GB Bigga	₦3100.0	30 days
29	6.5GB Bigga	₦3800.0	30 days
30	10GB Bigga	₦4600.0	30 days
31	15GB 365	₦14000.0	360 days
32	Freedom Best Effort	₦61500.0	30 days
33	35GB 365	₦29000.0	360 days
34	90GB Jumbo	₦31000.0	60 days
35	160GB Jumbo	₦53000.0	90 days
36	Freedom 6Mbs	₦46500.0	30 days
37	20GB Bigger	₦8000.0	30 days
38	25GB Bigger	₦9500.0	30 days
39	30GB Bigger	₦12500.0	30 days
40	40 Bigger	₦15500.0	30 days
41	60 Bigger	₦21000.0	30 days
42	75 Bigger	₦23000.0	30 days
43	Unlimited lite	₦18500.0	30 days
44	Unlimited essentials	₦27700.0	30 days
45	2GB midnight	₦1100.0	7 days
46	3GB midnight	₦1650.0	7 days
47	3GB weekend only	₦1650.0	1 weekend
48	Freedom 3mbps	₦38500.0	30 days

4. Buy Alpha

Endpoint URL

POST /api/alpha/

Description

This endpoint allows you to purchase Alpha Caller.

Request

• Method: POST
• Headers:
  • Authorization: Token <your_api_key>
• Body: JSON object containing the following:

{
  "phone": "2347056525656",
  "planid": "321"   // Alpha Plan Id Code
}

Response

• Status: 201 Created
• Body: JSON object representing the purchase result.

{
  "status": "success",
  "service": "Alpha",
  "msg": "You have successfully purchased 500 Alpha caller"
}

Alpha Plan list

Plan Id	Plan Name	Price (₦)	Validity
9	Alpha N600	₦600	30 days
10	Alpha N1100	₦1100	30 days
11	Alpha N1600	₦1600	30 days
12	Alpha N2100	₦2100	30 days
13	Alpha N2600	₦2600	30 days
14	Alpha N3120	₦3120	30 days
15	Alpha N3620	₦3620	30 days
16	Alpha N4150	₦4150	30 days

POST /api/kirani/

{
  "phone": "07000525656",
  "planid": "321"   // Kirani Plan Id Code
}

{
  "status": "success",
  "service": "kirani",
  "msg": "You have successfully purchased 500 minutes"
}