To Consume Our API You must have Generated a Token like 578b3ecde8d613c385413b5f1ca298bcb63c5d6afrom your dashboard

Balance

Balance API

https://otextcity.com/app/api/v1/balance.aspx?format=json&api-token=xxxxxxx

Example:

https://otextcity.com/app/api/v1/balance.aspx?format=json&api-token=578b3ecde8d613c385413b5f1ca298bcb63c5d6a&

Responses:

Success
{"status":200,"message":"success","balance":223900.0}
Failed
{'status': 400, 'message':'error', 'details': 'Bad Request Check Your Parameters'}
End of Balance API

Airtime

Airtime API

https://otextcity.com/app/api/v1/airtime.aspx?format=json&api-token=xxxxxxx&network=xxx&phone=xxxxxxxxxx&amount=xxx

Example:

https://otextcity.com/app/api/v1/airtime.aspx?format=json&api-token=578b3ecde8d613c385413b5f1ca298bcb63c5d6a&network=MTN&phone=08163524890&amount=1000

Parameters:
  • newtwork = network code (MTN for MTN, Glo for Glo, Airtel for Airtel, 9mobile for 9mobile)
  • phone = recipient number to top-up e.g 08163524890
  • amount = amount to top-up

Responses:

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

Data API

https://otextcity.com/app/api/v1/data.aspx?format=json&api-token=xxxxxxx&network=xxx&phone=xxxxxxxxxx&amount=xxx

Example:

https://otextcity.com/app/api/v1/data.aspx?format=json&api-token=578b3ecde8d613c385413b5f1ca298bcb63c5d6a&network=MTN&phone=08163524890&amount=1000

The above requested for MTN data for 08163524890 and data amount is 1000MB

Parameters:
  • newtwork = network code (MTN for MTN, Glo for Glo, Airtel for Airtel, 9mobile for 9mobile)
  • phone = recipient number to top-up e.g 08163524890
  • amount = data size in MB

Responses:

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

Cable

Cable Decoder API

Decoder Customer Check

https://otextcity.com/app/api/v1/check-cable-customer.aspx?format=json&api-token=xxxxxxx&smart_no=xxxxxx&service=xxxx

Example:

https://otextcity.com/app/api/v1/check-cable-customer.aspx?format=json&api-token=578b3ecde8d613c385413b5f1ca298bcb63c5d6a&smart_no=4131953321&service=dstv

Parameters:
  • smart_no = Customer IUC number
  • service = dstv/gotv/startimes

Responses:

Success
{"customer_name":"ESU INI OBONG BASSEY","smart_no":"4131953321","status":"OPEN","customer_number":"275953782","invoice":"1","expire_on":"13-11-2019","service":"dstv"}
Failed
{'status':'403', 'message': 'Update your profile to proceed'}
{ 'status': 422, 'message':'error', 'details':'invalid entries'}


Decoder Customer Subscription

https://otextcity.com/app/api/v1/cable.aspx?format=json&api-token=xxxxxxx&smart_no=xxxxxx&service=xxxx&phone=xxxxx&customer_name=xxxx&customer_number=xxxx&invoice=xxxx&plan_code=xxxx

Example:

https://otextcity.com/app/api/v1/cable.aspx?format=json&api-token=578b3ecde8d613c385413b5f1ca298bcb63c5d6a&smart_no=4131953321&service=dstv&phone=xxxxx&customer_name=xxxx&customer_number=xxxx&invoice=1&plan_code=xxxx

Parameters:
  • smart_no = Customer IUC number
  • service = dstv/gotv/startimes
  • phone = phone
  • customer_name = Customer name from check API
  • customer_number = Customer number from check API
  • invoice = Invoice from check API
  • plan_code = plan code Check Here

Responses:

Success
{'status':201, 'message':'success', 'details': 'Transaction Successful'}
Failed
{'status':205, 'message':'failure', 'details': 'Transaction Not Successful'}
{'status':400, 'message':'error', 'details':'Insufficient Balance'}
{'status':400, 'message':'Bad Request', 'details':' Bad Request check your paramaters'}
End of Cable Decoder API