\ API - Documentation | SmartDataBox

Get started

SmartDataBox API is a RESTful API that allows you to make data topup, airtime topup, cable subsription, electricity bills payment, etc.

    API Endpoint

        https://smartdatabox.com/api/

Authentication

SmartDataBox API uses Basic token Authentication Which should be passed through header as shown below. To get your API token you're required to Login

    "authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9
    .eyJhdWQiOiIxIiwianRpIj",

Response Type

Please note that all response are in json format

                RESPONSE | BODY

Buy Data

            
curl \
-X POST https://smartdatabox.com/api/buy/data

Request Headers
Content-Type: "application/json"
'ismart': "api",
"Accept": "application/json",
"Authorization": "Bearer Your_API_TOKEN"

Form Payload
{
	"network_id": 1,
	"dataType_id": 2,
	"plan_id": 2,
	"phone_number": "07038858824"
}


Response
{
    "success": true,
    "code": 200,
    "status": "successful",
    "data": {
        "service": "Data Topup",
        "amount": "100",
        "plan": "MTN 500MB Gifiting",
        "phone_number": "07038858824",
        "date": "2022-03-10T07:03:42.206113Z",
        "message": "MTN 500MB Gifiting to 07038858824",
        "reference": "BRVLZEVH8YWPAK7Z",
        "network": "MTN",
        "wallet_balance": 1055
    }
}

To get Network id
https://smartdatabox.com/api/documentation/network

To get data type id
https://smartdatabox.com/api/documentation/dataType

To get data plan id
https://smartdatabox.com/api/documentation/data

Buy Airtime

            
curl \
-X POST https://smartdatabox.com/api/buy/airtime

Request Headers
Content-Type: "application/json"
'ismart': "api",
"Accept": "application/json",
"Authorization": "Bearer Your_API_TOKEN"

Form Payload
{
	"network_id": 1,
	"type_id": 2,
	"amount": 100,
	"phone_number": "07038858824"
}


Response
{
    "success": true,
    "code": 200,
    "status": "successful",
    "data": {
        "service": "Airtime Topup",
        "network": "MTN",
        "type": "VTU",
        "amount": "100",
        "phone_number": "07038858824",
        "date": "2022-03-10T07:03:42.206113Z",
        "message": "MTN VTU 100 naira to 07038858824",
        "reference": "GYSLZEVH8YWPTS9E",
        "wallet_balance": 1055
    }
}

To get Network id
https://smartdatabox.com/api/documentation/network

To get airtime type id
https://smartdatabox.com/api/documentation/airtimeType

Cable Subscription

            
curl \
-X POST https://smartdatabox.com/api/buy/cable

Request Headers
Content-Type: "application/json"
'ismart': "api",
"Accept": "application/json",
"Authorization": "Bearer Your_API_TOKEN"

Form Payload
{
	"cable_id": 1,
	"plan_id": 2,
	"decoder_number": "38473895DE",
	"phone_number": "07038858824"
}


Response
{
    "success": true,
    "code": 200,
    "status": "successful",
    "data": {
        "service": "Cable Subscription",
        "Tv": "DSTV",
        "plan": "DStv Padi N1,850",
        "amount": "100",
        "phone_number": "07038858824",
        "date": "2022-03-10T07:03:42.206113Z",
        "message": "DStv Padi N1,850 naira
        to decoder number 38473895DE",
        "reference": "GYSLZEVH8YWPTS9E",
        "wallet_balance": 1055
    }
}

To get Cable id
https://smartdatabox.com/api/documentation/cableType

To get Cable Plan id
https://smartdatabox.com/api/documentation/cablePlan

Pay Bill

            
curl \
-X POST https://smartdatabox.com/api/pay-bill

Request Headers
Content-Type: "application/json"
'ismart': "api",
"Accept": "application/json",
"Authorization": "Bearer Your_API_TOKEN"

Form Payload
{
	"disco_id": 1,
	"meter_type": "PREPAID",
	"meter_number": "67573895RF",
	"amount": 1000,
        "phone_number": "07038858824"
}


Response
{
    "success": true,
    "code": 200,
    "status": "successful",
    "data": {
        "service": "Bill Payment",
        "bill": "Ikeja Electricity Company",
        "amount": "1000",
        "date": "2022-03-10T07:03:42.206113Z",
        "message": "IKEDC PREPAID to  67573895RF",
        "reference": "GYSLZEVH8YWPTS9E",
        "wallet_balance": 1055
    }
}

To get Disco id
https://smartdatabox.com/api/documentation/billType

meter_type
"POSTPAID" or "PREPAID"

Buy Exam Pin

            
curl \
-X POST https://smartdatabox.com/api/buy/exam-pin

Request Headers
Content-Type: "application/json"
'ismart': "api",
"Accept": "application/json",
"Authorization": "Bearer Your_API_TOKEN"

Form Payload
{
	"exam_id": 1,
	"quantity": 2,
}


Response
{
    "success": true,
    "code": 200,
    "status": "successful",
    "data": {
        "service": "Result Checker",
        "Exam": "Waec",
        "amount": 2300,
        "quantity": 2,
        "phone_number": "07038858824",
        "date": "2022-03-10T07:03:42.206113Z",
        "message": "2 pieces of Waec result checker",
        "reference": "GYSLZEVH8YWPTS9E",
        "wallet_balance": 1055
    }
}

To get Exam id
https://smartdatabox.com/api/documentation/examType