Fetch data plans available on a telco (network provider)

curl --request GET \
  --url https://api.nomba.com/v1/bill/data-plan/{telco} \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountid>'

import requests

url = "https://api.nomba.com/v1/bill/data-plan/{telco}"

headers = {
    "accountId": "<accountid>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {accountId: '<accountid>', Authorization: 'Bearer <token>'}
};

fetch('https://api.nomba.com/v1/bill/data-plan/{telco}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nomba.com/v1/bill/data-plan/{telco}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "accountId: <accountid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nomba.com/v1/bill/data-plan/{telco}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accountId", "<accountid>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nomba.com/v1/bill/data-plan/{telco}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accountId"] = '<accountid>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "00",
  "description": "SUCCESS",
  "message": "SUCCESS",
  "status": true,
  "data": [
    {
      "plan": "110MB Daily Plan",
      "amount": 100,
      "productId": "mtn1"
    },
    {
      "plan": "1GB + 1.5mins 1 day Plan",
      "amount": 500,
      "productId": "mtn16"
    },
    {
      "plan": "2.7GB+5mins Monthly Plan",
      "amount": 2000,
      "productId": "mtn6"
    },
    {
      "plan": "7GB Monthly Plan",
      "amount": 3500,
      "productId": "mtn30"
    },
    {
      "plan": "20GB Monthly Plan - 30days",
      "amount": 7500,
      "productId": "mtn5"
    }
  ]
}

{
  "code": "400",
  "description": "Request failed."
}

{
  "code": "401",
  "description": "Unauthorized"
}

{
  "code": "403",
  "description": "Forbidden"
}

{
  "code": "404",
  "description": "Record not found"
}

{
  "code": "429",
  "description": "Too many requests"
}

{
  "code": "500",
  "description": "Server error"
}

{
  "code": "400",
  "description": "Request failed."
}

GET

bill

data-plan

{telco}

Fetch data plans available on a telco (network provider)

curl --request GET \
  --url https://api.nomba.com/v1/bill/data-plan/{telco} \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountid>'

import requests

url = "https://api.nomba.com/v1/bill/data-plan/{telco}"

headers = {
    "accountId": "<accountid>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {accountId: '<accountid>', Authorization: 'Bearer <token>'}
};

fetch('https://api.nomba.com/v1/bill/data-plan/{telco}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nomba.com/v1/bill/data-plan/{telco}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "accountId: <accountid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nomba.com/v1/bill/data-plan/{telco}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accountId", "<accountid>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nomba.com/v1/bill/data-plan/{telco}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accountId"] = '<accountid>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "00",
  "description": "SUCCESS",
  "message": "SUCCESS",
  "status": true,
  "data": [
    {
      "plan": "110MB Daily Plan",
      "amount": 100,
      "productId": "mtn1"
    },
    {
      "plan": "1GB + 1.5mins 1 day Plan",
      "amount": 500,
      "productId": "mtn16"
    },
    {
      "plan": "2.7GB+5mins Monthly Plan",
      "amount": 2000,
      "productId": "mtn6"
    },
    {
      "plan": "7GB Monthly Plan",
      "amount": 3500,
      "productId": "mtn30"
    },
    {
      "plan": "20GB Monthly Plan - 30days",
      "amount": 7500,
      "productId": "mtn5"
    }
  ]
}

{
  "code": "400",
  "description": "Request failed."
}

{
  "code": "401",
  "description": "Unauthorized"
}

{
  "code": "403",
  "description": "Forbidden"
}

{
  "code": "404",
  "description": "Record not found"
}

{
  "code": "429",
  "description": "Too many requests"
}

{
  "code": "500",
  "description": "Server error"
}

{
  "code": "400",
  "description": "Request failed."
}

For a complete guide on response codes and transaction statuses, see Response Codes.

Authorizations

Authorization

string

header

required

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

accountId

string<uuid>

required

The parent accountId of the business.

Example:

"890022ce-bae0-45c1-9b9d-ee7872e6ca27"

Path Parameters

telco

string

required

Network provider

Response

OK - your request was successful.

code

string

required

Response Code

Example:

"00"

description

string

required

Response description

Example:

"SUCCESS"

message

string

required

Response message

Example:

"SUCCESS"

status

boolean

required

Request status

Example:

true

data

object[]

required

List of available data plans for the telco

Show child attributes

API Documentation

Authenticate

Accounts

Virtual Accounts

Online Checkout

Charge

Direct Debits

Transfers

Terminals

Transactions

Requery

Global Payout

DRC Collection

Airtime & Data Vending

Cable & Bill Payments

Betting

Fetch data plans available on a telco (network provider)

Authorizations

Headers

Path Parameters

Response