Fetch customer information from a cable tv provider

curl --request GET \
  --url https://api.nomba.com/v1/bill/cabletv/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountid>'

import requests

url = "https://api.nomba.com/v1/bill/cabletv/lookup"

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/cabletv/lookup', 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/cabletv/lookup",
  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/cabletv/lookup"

	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/cabletv/lookup")

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",
  "data": "John Doe"
}

{
  "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"
}

GET

bill

cabletv

lookup

Fetch customer information from a cable tv provider

curl --request GET \
  --url https://api.nomba.com/v1/bill/cabletv/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountid>'

import requests

url = "https://api.nomba.com/v1/bill/cabletv/lookup"

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/cabletv/lookup', 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/cabletv/lookup",
  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/cabletv/lookup"

	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/cabletv/lookup")

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",
  "data": "John Doe"
}

{
  "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"
}

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. Both methods return an access token. Send it in the Authorization header: Authorization: Bearer <access_token>.

Headers

accountId

string<uuid>

required

The parent accountId of the business.

Example:

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

Query Parameters

customerId

string

customerId

cableTvType

string

cableTvType

Response

OK - your request was successful.

code

string

required

Response Code

Example:

"00"

description

string

required

Response description

Example:

"Success"

data

string

required

The name of the customer

Example:

"John Doe"

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 customer information from a cable tv provider

Authorizations

Headers

Query Parameters

Response