Get Biller Categories
curl --request GET \
--url https://api-local.handle.ng/api/v1/bill-payment/categories \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-local.handle.ng/api/v1/bill-payment/categories"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-local.handle.ng/api/v1/bill-payment/categories', 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-local.handle.ng/api/v1/bill-payment/categories",
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>"
],
]);
$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-local.handle.ng/api/v1/bill-payment/categories"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-local.handle.ng/api/v1/bill-payment/categories")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-local.handle.ng/api/v1/bill-payment/categories")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"count": 28,
"categories": [
{
"id": "AIRTIME",
"name": "Airtime",
"itemCount": 19
},
{
"id": "DATA",
"name": "Data",
"itemCount": 274
},
{
"id": "INTERNET",
"name": "Internet",
"itemCount": 51
},
{
"id": "CABLE_TV",
"name": "Cable Tv",
"itemCount": 160
},
{
"id": "ELECTRICITY",
"name": "Electricity",
"itemCount": 50
},
{
"id": "UTILITIES",
"name": "Utilities",
"itemCount": 8
},
{
"id": "EDUCATION",
"name": "Education",
"itemCount": 12
},
{
"id": "FLIGHTS",
"name": "Flights",
"itemCount": 2
},
{
"id": "BETTING",
"name": "Betting",
"itemCount": 61
},
{
"id": "GAMING",
"name": "Gaming",
"itemCount": 12
},
{
"id": "SOLAR",
"name": "Solar",
"itemCount": 26
},
{
"id": "TRANSPORT",
"name": "Transport",
"itemCount": 3
},
{
"id": "ESIM",
"name": "Esim",
"itemCount": 6
},
{
"id": "GOVERNMENT",
"name": "Government",
"itemCount": 54
},
{
"id": "TAXES",
"name": "Taxes",
"itemCount": 12
},
{
"id": "HOSPITALS",
"name": "Hospitals",
"itemCount": 10
},
{
"id": "INSURANCE",
"name": "Insurance",
"itemCount": 8
},
{
"id": "RELIGIOUS",
"name": "Religious",
"itemCount": 15
},
{
"id": "ASSOCIATIONS",
"name": "Associations",
"itemCount": 20
},
{
"id": "FINANCIAL_SERVICES",
"name": "Financial Services",
"itemCount": 18
},
{
"id": "CREDIT_LOANS",
"name": "Credit Loans",
"itemCount": 14
},
{
"id": "MICRO_PENSIONS",
"name": "Micro Pensions",
"itemCount": 5
},
{
"id": "INVOICE",
"name": "Invoice",
"itemCount": 1
},
{
"id": "GIFT_CARDS",
"name": "Gift Cards",
"itemCount": 25
},
{
"id": "SHOPPING",
"name": "Shopping",
"itemCount": 15
},
{
"id": "FOOD_DINING",
"name": "Food Dining",
"itemCount": 10
},
{
"id": "LIFESTYLE_BEAUTY",
"name": "Lifestyle Beauty",
"itemCount": 8
},
{
"id": "HOME_LIVING",
"name": "Home Living",
"itemCount": 6
}
]
}Handle VAS & Bill Payments
Get Biller Categories
Retrieve all 28 supported biller categories (Utilities, Telcos, Government MDAs, Taxes, Hospitals, Universities, Lifestyle & Gift Cards) with active item counts.
GET
/
bill-payment
/
categories
Get Biller Categories
curl --request GET \
--url https://api-local.handle.ng/api/v1/bill-payment/categories \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-local.handle.ng/api/v1/bill-payment/categories"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-local.handle.ng/api/v1/bill-payment/categories', 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-local.handle.ng/api/v1/bill-payment/categories",
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>"
],
]);
$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-local.handle.ng/api/v1/bill-payment/categories"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-local.handle.ng/api/v1/bill-payment/categories")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-local.handle.ng/api/v1/bill-payment/categories")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"count": 28,
"categories": [
{
"id": "AIRTIME",
"name": "Airtime",
"itemCount": 19
},
{
"id": "DATA",
"name": "Data",
"itemCount": 274
},
{
"id": "INTERNET",
"name": "Internet",
"itemCount": 51
},
{
"id": "CABLE_TV",
"name": "Cable Tv",
"itemCount": 160
},
{
"id": "ELECTRICITY",
"name": "Electricity",
"itemCount": 50
},
{
"id": "UTILITIES",
"name": "Utilities",
"itemCount": 8
},
{
"id": "EDUCATION",
"name": "Education",
"itemCount": 12
},
{
"id": "FLIGHTS",
"name": "Flights",
"itemCount": 2
},
{
"id": "BETTING",
"name": "Betting",
"itemCount": 61
},
{
"id": "GAMING",
"name": "Gaming",
"itemCount": 12
},
{
"id": "SOLAR",
"name": "Solar",
"itemCount": 26
},
{
"id": "TRANSPORT",
"name": "Transport",
"itemCount": 3
},
{
"id": "ESIM",
"name": "Esim",
"itemCount": 6
},
{
"id": "GOVERNMENT",
"name": "Government",
"itemCount": 54
},
{
"id": "TAXES",
"name": "Taxes",
"itemCount": 12
},
{
"id": "HOSPITALS",
"name": "Hospitals",
"itemCount": 10
},
{
"id": "INSURANCE",
"name": "Insurance",
"itemCount": 8
},
{
"id": "RELIGIOUS",
"name": "Religious",
"itemCount": 15
},
{
"id": "ASSOCIATIONS",
"name": "Associations",
"itemCount": 20
},
{
"id": "FINANCIAL_SERVICES",
"name": "Financial Services",
"itemCount": 18
},
{
"id": "CREDIT_LOANS",
"name": "Credit Loans",
"itemCount": 14
},
{
"id": "MICRO_PENSIONS",
"name": "Micro Pensions",
"itemCount": 5
},
{
"id": "INVOICE",
"name": "Invoice",
"itemCount": 1
},
{
"id": "GIFT_CARDS",
"name": "Gift Cards",
"itemCount": 25
},
{
"id": "SHOPPING",
"name": "Shopping",
"itemCount": 15
},
{
"id": "FOOD_DINING",
"name": "Food Dining",
"itemCount": 10
},
{
"id": "LIFESTYLE_BEAUTY",
"name": "Lifestyle Beauty",
"itemCount": 8
},
{
"id": "HOME_LIVING",
"name": "Home Living",
"itemCount": 6
}
]
}Retrieve the complete list of all 28 active bill payment, utility, travel, institutional collection, and digital voucher categories supported on the Handle network.
Complete Categories Matrix
1. Utilities & Telecommunications
| Category ID | Display Name | Live Offerings | Description |
|---|---|---|---|
AIRTIME | Airtime | 19 items | Top-up airtime across MTN, Airtel, Glo, 9mobile |
DATA | Data | 274 items | Mobile and broadband data bundles (Daily, Weekly, Monthly) |
ELECTRICITY | Electricity | 50 items | All 11 Nigerian Electricity Distribution Companies (DisCos) |
CABLE_TV | Cable TV | 160 items | Pay TV bouquets for DSTV, GOtv, StarTimes, Showmax |
INTERNET | Internet | 51 items | Fixed fiber and wireless ISPs (Smile, Spectranet) |
SOLAR | Solar Energy | 26 items | Solar energy subscriptions and home power systems |
UTILITIES | Utilities | 8 billers | Municipal water boards and waste management utilities |
2. Education, Travel & Entertainment
| Category ID | Display Name | Live Offerings | Description |
|---|---|---|---|
EDUCATION | Education | 12 items | WAEC scratch cards, JAMB registration e-PINs, Universities |
FLIGHTS | Flights | 2 items | Multi-carrier domestic and regional airline flight bookings |
BETTING | Betting | 61 items | Wallet funding for Bet9ja, SportyBet, 1xBet, BangBet |
GAMING | Gaming Subscriptions | 12 items | PlayStation, Xbox Live, Steam, Nintendo digital cards |
TRANSPORT | Transport | 3 items | Cowry transit card topups and interstate bus transport |
ESIM | Global Travel eSIM | 6 items | Global travel roaming eSIM packs for 150+ countries |
3. Institutional & Government Collections
| Category ID | Display Name | Live Offerings | Description |
|---|---|---|---|
GOVERNMENT | Government Payments | 478 billers | Federal MDAs, State Governments, and TSA revenues |
TAXES | Taxes & Inland Revenue | 12 billers | FIRS, State Internal Revenue Services, Custom duties |
HOSPITALS | Hospitals | 10 billers | University Teaching Hospitals and Federal Medical Centres |
INSURANCE | Insurance | 8 billers | Health HMOs and motor/life insurance policies |
RELIGIOUS | Religious Institutions | 15 billers | Churches, Mosques, and Missions (Tithes & Offerings) |
ASSOCIATIONS | Associations & Societies | 20 billers | Professional bodies (COREN, NBA, ICAN, NIM) |
FINANCIAL_SERVICES | Financial Services | 18 billers | Microfinance, Investment, and FinTechs |
CREDIT_LOANS | Credit & Loans | 14 billers | Loan repayment and credit platforms |
MICRO_PENSIONS | Micro Pensions | 5 billers | PenCom and micro pension fund contributions |
INVOICE | Invoice Collections | 1 biller | Direct corporate electronic invoice settlement |
4. Lifestyle, Retail & Digital Gift Cards
| Category ID | Display Name | Live Offerings | Description |
|---|---|---|---|
GIFT_CARDS | Gift Cards & Vouchers | 25 items | Digital gift cards (Apple, Amazon, Steam, Shoprite, Spar) |
SHOPPING | Shopping & Retail | 15 items | E-commerce, supermarket, and mall shopping vouchers |
FOOD_DINING | Food & Dining | 10 items | Restaurant & food delivery credits (Chowdeck, Domino’s) |
LIFESTYLE_BEAUTY | Health & Beauty | 8 items | Spa treatments, salon, grooming, and wellness services |
HOME_LIVING | Home & Living | 6 items | Home furnishing, appliance maintenance, and cleaning vouchers |