Philiptech Simple API Documentation
Airtime Plan Network Codes
| Network Code | Network Name |
|---|---|
| MTNVTU | MTN |
| GLOVTU | GLO |
| 9MOBILEVTU | 9MOBILE |
| AIRTELVTU | AIRTEL |
Data Plan Network Codes
| Network Code | Network Name |
|---|---|
| mtn_gifting_data | MTN Gifting |
| mtn_sme_data | MTN SME |
| glo_data | GLO |
| 9mobile_data | 9mobile |
| airtel_data | Airtel |
Data price list and data ID
| Data ID | Network | – | Size | Data Type | Validity |
|---|---|---|---|---|---|
| 500MBG | MTN | – | 500.0 MB | GIFTING | 1 month |
| 1.0GBG | MTN | – | 1.0 GB | GIFTING | 1 month |
| 2.0GBG | MTN | – | 2.0 GB | GIFTING | 1 month |
| 3.0GBG | MTN | – | 3.0 GB | GIFTING | 1 month |
| 5.0GBG | MTN | – | 5.0 GB | GIFTING | 1 month |
| 10GBG | MTN | – | 10.0 GB | GIFTING | 1 month |
| 15GBG | MTN | – | 15.0 GB | GIFTING | 1 month |
| 20GBG | MTN | – | 20.0 GB | GIFTING | 1 month |
| 40GBG | MTN | – | 40.0 GB | GIFTING | 1 month |
| 500MB | MTN | – | 500 MB | SME | 1 month |
| 1GB | MTN | – | 1.0 GB | SME | 1 month |
| 2GB | MTN | – | 2.0 GB | SME | 1 month |
| 5GB | MTN | – | 3.0 GB | SME | 1 month |
| 10GB | MTN | – | 10.0 GB | SME | 1 month |
| G2.3GB | GLO | – | 2.3GB | GIFTING | 1 month |
| G3.75GB | GLO | – | 3.75GB | GIFTING | 1 month |
| G5.25GB | GLO | – | 5.25GB | GIFTING | 1 month |
| G7.0GB | GLO | – | 7.0GB | GIFTING | 1 month |
| G9.0GB | GLO | – | 9.0GB | GIFTING | 1 month |
| G12.0GB | GLO | – | 12.0GB | GIFTING | 1 month |
| G16.5GB | GLO | – | 16.5GB | GIFTING | 1 month |
| G25.0GB | GLO | – | 25.0GB | GIFTING | 1 month |
| G42.0GB | GLO | – | 42.0GB | GIFTING | 1 month |
| G78.0GB | GLO | – | 78.0GB | GIFTING | 1 month |
| G100GB | GLO | – | 100GB | GIFTING | 1 month |
| G115GB | GLO | – | 115GB | GIFTING | 1 month |
| A750MB | AIRTEL | – | 750MB | GIFTING | 1 month |
| A1.5GB | AIRTEL | – | 1.5GB | GIFTING | 1 month |
| A2GB | AIRTEL | – | 2GB | GIFTING | 1 month |
| A3GB | AIRTEL | – | 3GB | GIFTING | 1 month |
| A4.5GB | AIRTEL | – | 4.5GB | GIFTING | 1 month |
| A6GB | AIRTEL | – | 6GB | GIFTING | 1 month |
| A11GB | AIRTEL | – | 11GB | GIFTING | 1 month |
| A40GB | AIRTEL | – | 40GB | GIFTING | 1 month |
| A75GB | AIRTEL | – | 75GB | GIFTING | 1 month |
| A110GB | AIRTEL | – | 110GB | GIFTING | 1 month |
Balance API
----------------------------
METHOD: GET
https://portal.philiptech.com.ng/api/v1/balance?format=json&api-token=xxxxxxx
Example:
https://portal.philiptech.com.ng/api/v1/balance?format=json&api-token=API_TOKEN&
Response Codes:
Success
{"status":200,"message":"success","balance":223900.0}
Failed
{'status': 400, 'message':'error', 'details': 'Bad Request Check Your Parameters'}
End of Balance API
Airtime API
---------------------------
METHOD: GET
https://portal.philiptech.com.ng/api/v1/airtime?format=json&apitoken=xxxxxxx&network=xxx&phone=xxxxxxxxxx&amount=xxx
Example:
https://portal.philiptech.com.ng/api/v1/airtime?format=json&apitoken=API_TOKEN&network=MTNVTU&phone=08068725584&amount=100
Parameters:
newtwork = network code E.g "mtn_airtime" "glo_airtime"
"MTNVTU" for MTN Airtime TopUp
"GLOVTU" for Glo Airtime TopUp
"AIRTELVTU" for Airtel Airtime TopUp
"9MOBILEVTU" for 9mobile Airtime TopUp
phone = Recipient Number to top-up and must start with zero e.g 08144216361
amount = Amount to Recharge. E.g 100,500, 1000 etc
Response Codes:
Success
{'status':201, 'message':'success', 'details': 'Transaction Successful'}
Failed
{'status':'403', 'message': 'Update your profile to proceed'}
{'status':205, 'message':'failure', 'details': 'Transaction not Successful'}
{'status': 422, 'message':'error', 'details':'Insufficient Balance'}
{'status': 400, 'message':'error', 'details': 'Bad Request Check Your Parameters'}
End of Airtime API
Data API
-----------------------
METHOD: GET
https://portal.philiptech.com.ng/api/v1/data?format=json&apitoken=xxxxxxx&network=xxx&phone=xxxxxxxxxx&amount=xxx
Example:
https://portal.philiptech.com.ng/api/v1/data?format=json&apitoken=API_TOKEN&network=mtn_gifting_data&phone=08144216361&amount=M500MBG
The above requested for MTN gifting Data to Recipient Number 08144216361 and data amount is 500MB
Parameters:
newtwork = network code E.g "mtn_gifting_data" "airtel_data"
"mtn_gifting_data" for MTN Gifting Data Bundles
"mtn_sme_data" for MTN SME Data Bundles
"glo_data" for Glo Data Bundles
"airtel_data" for Airtel Data Bundles
"9mobile_data" for 9mobile Data Bundles
phone = Recipient Number and must start with zero E.g 08144216361
amount = Data unique ID. E.g "M1GBG" "M2GBG" "M3GBG" etc
Response Codes:
Success
{'status':201, 'message':'success', 'details': 'Transaction Successful'}
Failed
{'status':'403', 'message': 'Update your profile to proceed'}
{'status':205, 'message':'failure', 'details': 'Transaction not Successful'}
{'status': 422, 'message':'error', 'details':'Insufficient Balance'}
{'status': 400, 'message':'error', 'details': 'Bad Request Check Your Parameters'}
End of Data API