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
472	Voice call, (40 mins + 2.5GB + 5 SMS ) 💯💯💯	₦2000	₦2000	₦2000	7 Days
471	Voice call, (20 mins + 1.2GB + 5 SMS ) 💯💯💯	₦1000	₦1000	₦1000	7 Days
469	Voice call, (100 mins + 12GB + 5 SMS ) 💯💯💯	₦5000	₦5000	₦5000	30 Days
470	Voice call, (10 mins + 400MB + 5 SMS ) 💯💯💯	₦500	₦500	₦500	7 Days
409	MTN SME ( 3.5GB )	₦1500	₦1500	₦1500	7 Days
475	MTN SME ( 5.0GB ).	₦3500	₦3500	₦3500	30 Days
474	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
284	MTN SME ( 500MB )	₦430	₦430	₦430	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
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
388	MTN GIFTING ( 11 GB )	₦3550	₦3550	₦3550	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
374	MTN DIRECT 🎁 ( 5GB + 90mnt of call + 220 Bulk SMS )	₦3100	₦3100	₦3100	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
422	GLO GIFTING 🎁 9.8 GB incl. 3.5GB Night	₦2000	₦2000	₦2000	30 Days
423	GLO GIFTING 🎁 8.5GB incl 2.5GB Night Data	₦2000	₦2000	₦2000	7 Days
346	GLO GIFTING 🎁 750MB Night	₦125	₦125	₦125	1 Days
345	GLO GIFTING 🎁 750MB	₦210	₦210	₦210	1 Days
424	GLO GIFTING 🎁 7.25 GB incl. 3GB Night	₦2500	₦2500	₦2500	30 Days
421	GLO GIFTING 🎁 6.15 GB incl. 3GB Night	₦2000	₦2000	₦2000	30 Days
420	GLO GIFTING 🎁 5.9GB incl. 2GB Night	₦1500	₦1500	₦1500	7 Days
419	GLO GIFTING 🎁 5 GB incl. 3GB Night	₦1500	₦1500	₦1500	30 Days
344	GLO GIFTING 🎁 45MB	₦53	₦53	₦53	1 Days
417	GLO GIFTING 🎁 4.2 GB incl. 2GB Night Data	₦1000	₦1000	₦1000	30 Days
418	GLO GIFTING 🎁 3.5GB incl 2GB Night	₦1000	₦1000	₦1000	30 Days
348	GLO GIFTING 🎁 235MB	₦220	₦220	₦220	2 Days
416	GLO GIFTING 🎁 2.6 GB incl. 1.5GB Night	₦1000	₦1000	₦1000	30 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
425	GLO GIFTING 🎁 10 GB incl. 2GB Night	₦3000	₦3000	₦3000	30 Days
414	GLO GIFTING 🎁 1.8GB Social plan	₦500	₦500	₦500	15 Days
350	GLO GIFTING 🎁 1.5GB	₦320	₦320	₦320	1 Days
415	GLO GIFTING 🎁 1.5 GB + 1 Hour - My-G	₦500	₦500	₦500	7 Days
413	GLO GIFTING 🎁 1 GB + 1 Hour - My-G Bundle	₦310	₦310	₦310	3 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
466	Airtel GIFTING ( 8.0 GB )	₦3000	₦3000	₦3000	30 Days
465	Airtel GIFTING ( 6.0 GB )	₦2500	₦2500	₦2500	7 Days
448	Airtel GIFTING ( 500MB )	₦481	₦500	₦500	1 Days
460	Airtel GIFTING ( 5.0 GB )	₦1700	₦1700	₦1700	5 Days
464	Airtel GIFTING ( 4.0 GB )	₦2500	₦2500	₦2500	30 Days
451	Airtel GIFTING ( 300MB ) social plan	₦310	₦310	₦310	3 Days
461	Airtel GIFTING ( 3.5 GB )	₦1500	₦1500	₦1500	7 Days
459	Airtel GIFTING ( 3.0 GB )	₦1000	₦1000	₦1000	2 Days
463	Airtel GIFTING ( 3.0 GB )	₦2000	₦2000	₦2000	30 Days
450	Airtel GIFTING ( 200MB )	₦210	₦210	₦210	1 Days
462	Airtel GIFTING ( 2.0 GB )	₦1500	₦1500	₦1500	30 Days
449	Airtel GIFTING ( 100MB )	₦105	₦105	₦105	1 Days
467	Airtel GIFTING ( 10 GB )	₦3000	₦3000	₦3000	7 Days
468	Airtel GIFTING ( 10 GB )	₦4000	₦4000	₦4000	30 Days
453	Airtel GIFTING ( 1.5GB )	₦600	₦600	₦600	2 Days
452	Airtel GIFTING ( 1.0 GB )	₦800	₦800	₦800	7 Days
454	Airtel GIFTING ( 1.5GB )	₦1000	₦1000	₦1000	7 Days
445	AIRTEL Awoof 🎁 ( 600 MB )	₦250	₦250	₦250	2 Days
444	AIRTEL Awoof 🎁 ( 300 MB )	₦135	₦135	₦135	2 Days
443	AIRTEL Awoof 🎁 ( 150MB )	₦80	₦80	₦80	1 Days
447	AIRTEL Awoof 🎁 ( 1.5 GB )	₦450	₦450	₦450	1 Days
446	AIRTEL Awoof 🎁 ( 1.0 GB )	₦350	₦350	₦350	1 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"
}