Skip to main content
You can find out the available data plans you can pick from when trying to buy internet data.

​
Request

[POST]
{{baseUrl}}/api/v1/purchase/data

​
Body parameter

ParametersTypeDescription
plan *stringPlan type e.g *9MOBILE_1.5GB*
destination *integermobile number to receive data

​
Sample response

Response
{
    "entity": {
        "phone_number": "2348012345678",
        "amount": 200,
        "network": "MTN 200 MB DATA BUNDLE",
        "reference_id": "dj_e076726b-b136-4e18-b63d-3eabc77d56c1"
    }
}

​
Response Fields

FieldTypeDescription
entityobjectContains the response data
entity.phone_numberstringMobile number that received the data
entity.amountnumberCost of the data plan in NGN
entity.networkstringNetwork and data plan description
entity.reference_idstringUnique reference ID for the transaction

​
Data plans

Fetch list of data plans available

​
Request

[GET]
{{baseUrl}}api/v1/purchase/data/plans

​
Sample response

Response
{
    "entity": [
        {
            "amount": 1000,
            "description": "9MOBILE 1.5GB data bundle",
            "plan": "9MOBILE_1.5GB"
        },
        {
            "amount": 2000,
            "description": "9MOBILE 4.5GB data bundle",
            "plan": "9MOBILE_4.5GB"
        },...
  ]
}

​
Response Fields

FieldTypeDescription
entityarrayList of available data plans
entity[].amountnumberCost of the data plan in NGN
entity[].descriptionstringHuman-readable description of the data plan
entity[].planstringPlan identifier to use when purchasing data