Skip to main content
GET
Get VAS Catalog
Fetch the complete catalog of supported utilities, telcos, TV packages, travel offers, lifestyle vouchers, and institutional billers directly from Handle’s unified catalog engine.

Supported Category Types

1. Utilities & Telecommunications

  • AIRTIME — Top-up airtime across MTN, Airtel, Glo, 9mobile.
  • DATA — Broadband and mobile data bundles (Daily, Weekly, Monthly, Unlimited).
  • ELECTRICITY — All 11 Nigerian Distribution Companies (DisCos) for prepaid & postpaid meters.
  • CABLE_TV — DSTV, GOtv, StarTimes, Showmax bouquets.
  • INTERNET — Fixed fiber & wireless ISPs (Smile, Spectranet).
  • SOLAR — Solar energy subscriptions and home power systems.
  • UTILITIES — Municipal water boards and waste management utilities.

2. Education, Travel & Entertainment

  • EDUCATION — WAEC scratch cards, JAMB registration e-PINs, and Universities.
  • FLIGHTS — Multi-carrier flight bookings (Air Peace, Ibom Air, etc.).
  • BETTING — Wallet funding for Bet9ja, SportyBet, 1xBet, BangBet.
  • GAMING — PlayStation, Xbox Live, Steam digital cards.
  • TRANSPORT — Cowry transit card topups and interstate bus transport.
  • ESIM — Global travel roaming eSIM data packs.

3. Institutional & Government Collections

  • GOVERNMENT — Federal Ministries, Departments & Agencies (MDAs), TSA revenues, CAC, FRSC.
  • TAXES — Federal Inland Revenue Service (FIRS), State Internal Revenue Services (LIRS, KADIRS), Customs.
  • HOSPITALS — University Teaching Hospitals (LUTH, UCH, FMC) and specialist medical centers.
  • INSURANCE — Health HMOs and motor/life insurance policies.
  • RELIGIOUS — Churches, Mosques, and Missions.
  • ASSOCIATIONS — Professional bodies (NBA, ICAN, COREN, NIM).
  • FINANCIAL_SERVICES & CREDIT_LOANS — Microfinance, credit repayments, and investment schemes.
  • MICRO_PENSIONS & INVOICE — Pension contributions and direct invoice settlement.

4. Lifestyle & Digital Vouchers

  • GIFT_CARDS — Digital gift cards and retail vouchers.
  • SHOPPING — E-commerce, supermarket, and mall shopping vouchers.
  • FOOD_DINING — Restaurant and food delivery credits.
  • LIFESTYLE_BEAUTY — Spa, salon, and wellness services.
  • HOME_LIVING — Home furnishing and appliance vouchers.

Dynamic Routing Convention

  • Passing category (e.g. category=GOVERNMENT or category=ELECTRICITY): Returns all available offerings or registered billers for that industry.
  • Passing billerCode (e.g. billerCode=S0000573002 or billerCode=AEDC): Returns all fee products, tariffs, and dynamic customFields for that specific biller.

Authorizations

Authorization
string
header
default:sk_test_handle_master_key
required

Supply your secret API key (e.g. sk_live_... or sk_test_...) in the Authorization header.

Query Parameters

category
enum<string>
default:ELECTRICITY

Category filter (Retail VAS, Travel, Lifestyle, or Institutional)

Available options:
AIRTIME,
DATA,
INTERNET,
CABLE_TV,
ELECTRICITY,
UTILITIES,
EDUCATION,
FLIGHTS,
BETTING,
GAMING,
SOLAR,
TRANSPORT,
ESIM,
GOVERNMENT,
TAXES,
HOSPITALS,
INSURANCE,
RELIGIOUS,
ASSOCIATIONS,
FINANCIAL_SERVICES,
CREDIT_LOANS,
MICRO_PENSIONS,
INVOICE,
GIFT_CARDS,
SHOPPING,
FOOD_DINING,
LIFESTYLE_BEAUTY,
HOME_LIVING
billerCode
string

Biller provider code (e.g. AEDC, IKEDC, MTN, DSTV, WAEC)

Response

200 - application/json

Catalog items retrieved

count
integer
Example:

2

category
string
Example:

"ELECTRICITY"

items
object[]