Fetch Data Plans

Get a list of available data bundles that can be purchased based on the network or telco

Fetch Data Plans

GET /v1/bill/data-plan/{telco}

The plans, amounts, and productIds in the example response are illustrative only — they do not represent real, current plans. This catalog can change at any time. Never hardcode plan data from this example: always call this endpoint live and use the productId it returns in your purchase request.

Path parameters

telco · string · required

Telco i.e. network provider for the data plan to be purchased. Typically mtn, airtel, glo or 9mobile

Response body

code · string · required

Response code

description · string · required

Response description

message · string · required

Response message

status · boolean · required

Request status

data · object[]

List of available data plans for the telco supplied

Hide object

amount · integer · required

The corresponding amount for this plan

plan · string · required

Plan name

productId · string · required

The unique identifier for this data plan. Pass this value as productId in the Buy Data Bundle request to purchase this exact bundle.

Request

curl --location 'https://api.nomba.com/v1/bill/data-plan/mtn' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>'

Success response (200)

{
    "code": "00",
    "description": "SUCCESS",
    "message": "SUCCESS",
    "status": true,
    "data": [
        {
            "plan": "20MB -> 1Day (N50)",
            "amount": 50,
            "productId": "example-plan-id-1"
        },
        {
            "plan": "75MB -> 1Day (N100)",
            "amount": 100,
            "productId": "example-plan-id-2"
        },
        {
            "plan": "200MB -> 3Days (N200)",
            "amount": 200,
            "productId": "example-plan-id-3"
        },
        {
            "plan": "350MB -> 7Days (N300)",
            "amount": 300,
            "productId": "example-plan-id-4"
        },
        {
            "plan": "750MB -> 14Days (N500)",
            "amount": 500,
            "productId": "example-plan-id-5"
        },
        {
            "plan": "1.5GB -> 30Days (N1,000)",
            "amount": 1000,
            "productId": "example-plan-id-6"
        },
        {
            "plan": "3.5GB -> 30Days (N1,500)",
            "amount": 1500,
            "productId": "example-plan-id-7"
        },
        {
            "plan": "5.5GB -> 30Days (N2,500)",
            "amount": 2500,
            "productId": "example-plan-id-8"
        }
    ]
}