To Consume your VBP API You must have Generated a Token like
578b3ecde8d613c385413b5f1ca298bcb63c5d6a
from your dashboard

Balance

Balance API

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

Example:

https://yourdoamin.com/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://yourdoamin.com/api/v1/airtime.aspx?format=json&api-token=xxxxxxx&network=xxx&phone=xxxxxxxxxx&amount=xxx

Example:

https://yourdoamin.com/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://yourdoamin.com/api/v1/data.aspx?format=json&api-token=xxxxxxx&network=xxx&phone=xxxxxxxxxx&amount=xxx

Example:

https://yourdoamin.com/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://yourdoamin.com/api/v1/check-cable-customer.aspx?format=json&api-token=xxxxxxx&smart_no=xxxxxx&service=xxxx

Example:

https://yourdoamin.com/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://yourdoamin.com/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://yourdoamin.com/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 Generate that one by yourself

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

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

CHECK HERE FOR API

Note: Convinience Fee of #35 Naira will be added to the costs

DSTV Plan Codes

DSTVCodesCost
DSTV Fta Plus DstvFtaPlus 1600
DSTV ACCESS DstvAccess 2000
DSTV FAMILY DstvFamily 4000
DSTV Asia Bouqet DstvAsiaBouqet 5400
DSTV COMPACT DstvCompact 6800
DSTV COMPACT PLUS DstvPlus 10650
DSTV PREMIUM DstvPremium 15800
DSTV PREMIUM HD/Extra View DstvPremiumEx 18000
DSTV Premium Asia DStvPremiumAsia 19900

GOTV Plan Codes

GOTVCodesCost
GOTV LITE GotvL 400
GOTV VALUE GotvV 1250
GOTV PLUS GotvP 1900
GOTV MAX GotvM 3200

STARTIMES Plan Codes

STARTIMESCodesCost
Startimes Nova StarN 900
Startimes Basic StarB 1300
Startimes Smart StarS 1900
Startimes Classic StarC 2600
Startimes Unique StarU 3800
Startimes Super StarS 3800

Valued Customer ,
Thanks for your patronage ,
You can now purchase DATA without you having data at all you need is your USERNAME. In case your data suddenly get exhausted you can just send an SMS to our keyword and you will be TopUp instantly provided you have sufficient funds in your account for the chosen subscription.

Procedure to Subscribe Without Data

  • Register if you haven't
  • Make sure you have sufficient Credits i.e OC credits if not Fund Here
  • Send E.g "OTXTMD space username,number on profile,data size in MB,number to Topup" to 09087239684

    Example

  • Example means that:
    Your otextcity username = username
    Number registered in username's profile = 2348180008000 (must be that format)
    The data amount = 1gb
    Number that will receive the data= 08163524890
    Our bot has a number 09087239684 that will receive the message and notify our system so your account with username "username" on otextcity will be debited and data will be credited to 08163524890 immediately

  • If you did not receive any top-up within 30min to 1hour, kindly contact us on 08163524890

Full List of Network Keywords

NetworkKeywords
MTN OTXTMD
GLO OTXTGL
AIRTEL OTXTAR
9MOBILE OTXTMO