Airtime & Data Vending
Fetch Data Plans
Introduction
- Welcome to Nomba
- Get API Keys
- Testing
Getting Started
- Dashboard Setup
- Authentication
- Definitions
Plugins and SDKs
Products
- Accounts
- Accept Payments
- Transfers
- Terminals
- Webhooks
- Transactions
- Airtime & Data Vending
- Cable & Bill Payments
Guides
API Patterns
Airtime & Data Vending
Fetch Data Plans
Get a list of available data bundles that can be purchased based on the network or telco
curl --location 'https://api.nomba.com/v1/bill/data-plan/<telco>' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"plan": "20MB -> 1Day (N50)",
"amount": 50
},
{
"plan": "75MB -> 1Day (N100)",
"amount": 100
},
{
"plan": "200MB -> 3Days (N200)",
"amount": 200
},
{
"plan": "350MB -> 7Days (N300)",
"amount": 300
},
{
"plan": "750MB -> 14Days (N500)",
"amount": 500
},
{
"plan": "1.5GB -> 30Days (N1,000)",
"amount": 1000
},
{
"plan": "3.5GB -> 30Days (N1,500)",
"amount": 1500
},
{
"plan": "5.5GB -> 30Days (N2,500)",
"amount": 2500
},
{
"plan": "6.5GB -> 30Days (N3,000)",
"amount": 3000
},
{
"plan": "9.5GB -> 30Days (N4,000)",
"amount": 4000
},
{
"plan": "12GB -> 30Days (N5,000)",
"amount": 5000
},
{
"plan": "25GB -> 30Days (N10,000)",
"amount": 10000
},
{
"plan": "40GB -> 30Days (N15,000)",
"amount": 15000
}
],
"description": "Successful",
"code": 200
}
GET /v1/bill/data-plan/<telco>
Path parameters
Telco i.e. network provider for the data plan to be purchased. Typically mtn, airtel, glo or 9mobile
Response body
Response code
Response description
curl --location 'https://api.nomba.com/v1/bill/data-plan/<telco>' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"plan": "20MB -> 1Day (N50)",
"amount": 50
},
{
"plan": "75MB -> 1Day (N100)",
"amount": 100
},
{
"plan": "200MB -> 3Days (N200)",
"amount": 200
},
{
"plan": "350MB -> 7Days (N300)",
"amount": 300
},
{
"plan": "750MB -> 14Days (N500)",
"amount": 500
},
{
"plan": "1.5GB -> 30Days (N1,000)",
"amount": 1000
},
{
"plan": "3.5GB -> 30Days (N1,500)",
"amount": 1500
},
{
"plan": "5.5GB -> 30Days (N2,500)",
"amount": 2500
},
{
"plan": "6.5GB -> 30Days (N3,000)",
"amount": 3000
},
{
"plan": "9.5GB -> 30Days (N4,000)",
"amount": 4000
},
{
"plan": "12GB -> 30Days (N5,000)",
"amount": 5000
},
{
"plan": "25GB -> 30Days (N10,000)",
"amount": 10000
},
{
"plan": "40GB -> 30Days (N15,000)",
"amount": 15000
}
],
"description": "Successful",
"code": 200
}
curl --location 'https://api.nomba.com/v1/bill/data-plan/<telco>' \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"plan": "20MB -> 1Day (N50)",
"amount": 50
},
{
"plan": "75MB -> 1Day (N100)",
"amount": 100
},
{
"plan": "200MB -> 3Days (N200)",
"amount": 200
},
{
"plan": "350MB -> 7Days (N300)",
"amount": 300
},
{
"plan": "750MB -> 14Days (N500)",
"amount": 500
},
{
"plan": "1.5GB -> 30Days (N1,000)",
"amount": 1000
},
{
"plan": "3.5GB -> 30Days (N1,500)",
"amount": 1500
},
{
"plan": "5.5GB -> 30Days (N2,500)",
"amount": 2500
},
{
"plan": "6.5GB -> 30Days (N3,000)",
"amount": 3000
},
{
"plan": "9.5GB -> 30Days (N4,000)",
"amount": 4000
},
{
"plan": "12GB -> 30Days (N5,000)",
"amount": 5000
},
{
"plan": "25GB -> 30Days (N10,000)",
"amount": 10000
},
{
"plan": "40GB -> 30Days (N15,000)",
"amount": 15000
}
],
"description": "Successful",
"code": 200
}