Production-ready REST APIs for Nigerian fintech. Banking, KYC verification, exchange rates, crypto, telecom, and more. 152 free endpoints, 16 categories.
158 endpoints
/api/v1/banks
Get all Nigerian banks with NIBSS codes, SWIFT, fees, digital services, and branch info
/api/v1/banks/holidays
Nigerian bank holidays and non-working days for 2026
/api/v1/banks/bins
Nigerian card Bank Identification Number (BIN) prefix directory
/api/v1/banks/bins/:prefix
Look up card issuer by BIN prefix
/api/v1/banks/gateways
Nigerian payment gateway providers with fees, supported channels, and integration details
/api/v1/banks/transfer-fees
Inter-bank and intra-bank transfer fee schedule (NIP, NEFT, RTGS)
/api/v1/banks/compare
Compare multiple banks side by side on fees, features, rates, and services
/api/v1/banks/stats
Nigerian banking sector aggregate statistics
/api/v1/banks/:code
Full details for a specific bank by NIBSS code
/api/v1/banks/:code/fees
Detailed fee breakdown for a specific bank (transfers, maintenance, ATM, SMS)
/api/v1/banks/:code/features
Bank product features including mobile app, internet banking, USSD, cards
/api/v1/banks/:code/account-types
Available account types (savings, current, domiciliary, fixed deposit) with requirements
/api/v1/banks/:code/digital
Digital banking channels and capabilities for a bank
/api/v1/banks/:code/rates
Savings interest rates, loan rates, and FX rates for a bank
/api/v1/banks/:code/info
Corporate information including SWIFT code, NIBSS code, headquarters, CEO, website
/api/v1/banks/:code/branches
Branch and ATM count information for a bank
/api/v1/geo/states
All 36 states + FCT with population, area, capital, governor, LGAs, and economic data
/api/v1/geo/states/:code
Full details for a specific state including demographics, economy, and infrastructure
/api/v1/geo/states/:code/lgas
All Local Government Areas within a state
/api/v1/geo/states/:code/cities
Major cities and towns within a state with population estimates
/api/v1/geo/states/:code/industries
Major industries and economic activities in a state
/api/v1/geo/states/:code/rent
Average rent prices for different property types in a state
/api/v1/geo/states/:code/postal-codes
Postal/ZIP codes for areas within a state
/api/v1/geo/states/:code/demographics
Demographic information and statistics for a state
/api/v1/geo/zones
Nigeria six geopolitical zones with member states
/api/v1/geo/zones/:name
States within a specific geopolitical zone
/api/v1/geo/lgas
Search across all 774 Local Government Areas in Nigeria
/api/v1/geo/capitals
All 36 state capitals plus FCT
/api/v1/geo/search
Search across states, cities, and LGAs
/api/v1/geo/stats
Aggregate geographic statistics for Nigeria
/api/v1/telecom/providers
All Nigerian mobile network operators (MTN, Airtel, Glo, 9mobile) with details
/api/v1/telecom/providers/:code
Full details for a specific mobile carrier
/api/v1/telecom/providers/:code/plans
Mobile data plans for a carrier with prices, validity, and data allocation
/api/v1/telecom/providers/:code/prefixes
Phone number prefixes allocated to a carrier
/api/v1/telecom/providers/:code/ussd
USSD short codes for balance check, data purchase, airtime transfer, etc.
/api/v1/telecom/providers/:code/customer-care
Customer service contact numbers, email, social media for a carrier
/api/v1/telecom/lookup/:phone
Identify the mobile carrier for a Nigerian phone number
/api/v1/telecom/prefixes
Complete map of Nigerian phone prefixes to carriers
/api/v1/telecom/prefixes/:prefix
Look up which carrier owns a specific phone prefix
/api/v1/telecom/isps
Nigerian Internet Service Providers with coverage, plans, and contact info
/api/v1/telecom/isps/:name
Details for a specific Internet Service Provider
/api/v1/telecom/ncc
Nigerian Communications Commission regulatory information
/api/v1/telecom/stats
Nigerian telecom sector aggregate statistics
/api/v1/tax/paye
Personal income tax (PAYE) brackets and rates under Nigerian tax law
/api/v1/tax/paye/calculate
Calculate Pay-As-You-Earn tax for a given annual income
/api/v1/tax/vat
Value Added Tax rate, exempt items, and zero-rated supplies
/api/v1/tax/vat/calculate
Calculate VAT amount for a given value
/api/v1/tax/wht
Withholding Tax rates by income type (dividends, rent, contracts, etc.)
/api/v1/tax/wht/:type
Withholding Tax rate for a specific income type
/api/v1/tax/cit
Companies Income Tax information with rates by company size
/api/v1/tax/cit/calculate
Calculate Companies Income Tax based on profit and turnover
/api/v1/tax/net-salary
Calculate take-home pay from gross salary after PAYE, pension, NHF, and NHIS deductions
/api/v1/tax/capital-gains
Capital Gains Tax rate and information for Nigeria
/api/v1/tax/stamp-duty
Stamp duty rates by document type
/api/v1/tax/pension
Contributory Pension Scheme rates (employee and employer contributions)
/api/v1/tax/nhf
National Housing Fund contribution rate and information
/api/v1/tax/allowances
Consolidated relief allowance and other personal tax allowances
/api/v1/tax/authorities
Federal and state tax authorities (FIRS, LIRS, etc.) with contact information
/api/v1/tax/calendar
Tax filing deadlines and due dates for the year
/api/v1/tax/summary
Complete overview of Nigerian tax system with all rates and rules
/api/v1/education/universities
All Nigerian universities (federal, state, private) with JAMB cutoffs, tuition, courses, and rankings
/api/v1/education/universities/:acronym
Full details for a specific university
/api/v1/education/polytechnics
Nigerian polytechnics and monotechnics with programs and fees
/api/v1/education/polytechnics/:acronym
Full details for a specific polytechnic
/api/v1/education/jamb
Joint Admissions and Matriculation Board examination information
/api/v1/education/nysc
National Youth Service Corps program information and requirements
/api/v1/education/professional-bodies
Nigerian professional bodies and regulatory organizations (ICAN, NBA, NMA, COREN, etc.)
/api/v1/education/professional-bodies/:acronym
Details for a specific professional body including membership requirements
/api/v1/education/stats
Nigerian education sector statistics
/api/v1/education/search
Search across all educational institutions
/api/v1/identity/validate/bvn
Validate Bank Verification Number format (11 digits)
/api/v1/identity/validate/nin
Validate National Identification Number format (11 digits)
/api/v1/identity/validate/nuban
Validate Nigerian Uniform Bank Account Number using NUBAN algorithm
/api/v1/identity/validate/phone
Validate Nigerian phone number format and identify carrier
/api/v1/identity/validate/email
Validate email address format and check domain
/api/v1/identity/validate/tin
Validate Tax Identification Number format
/api/v1/identity/validate/cac
Validate Corporate Affairs Commission registration number format
/api/v1/identity/validate/voters-card
Validate Voter Identification Number format
/api/v1/identity/validate/drivers-license
Validate Nigerian driver license number format
/api/v1/identity/validate/passport
Validate Nigerian international passport number format
/api/v1/identity/lookup/bvn
Real-time BVN verification via KYC provider. Returns verified identity data including name, date of birth, and phone number.
/api/v1/identity/lookup/nin
Real-time NIN/VNIN verification via KYC provider. Returns verified identity data including name, date of birth, gender, and state of origin.
/api/v1/identity/documents
Overview of all Nigerian identity documents with requirements and issuing authorities
/api/v1/identity/documents/:type
Detailed information about a specific identity document type
/api/v1/rates/currencies
Current exchange rates for 30+ currencies against NGN (CBN and parallel market)
/api/v1/rates/currencies/:code
Current exchange rate for a specific currency against NGN
/api/v1/rates/convert
Convert between currencies using current NGN rates
/api/v1/rates/history/usd-ngn
Historical USD to NGN exchange rate data
/api/v1/rates/bdc
Bureau de Change (BDC) and parallel market exchange rates
/api/v1/rates/crypto
Cryptocurrency prices in Nigerian Naira (BTC, ETH, USDT, SOL, etc.)
/api/v1/rates/crypto/:symbol
Current price of a specific cryptocurrency in NGN
/api/v1/rates/crypto/exchanges
Nigerian cryptocurrency exchanges with trading pairs, fees, and features
/api/v1/rates/crypto/exchanges/:name
Details for a specific Nigerian crypto exchange
/api/v1/rates/crypto/validate-wallet
Validate cryptocurrency wallet address format for major chains
/api/v1/rates/stats
Exchange rate and crypto market statistics
/api/v1/utilities/electricity/discos
All 11 electricity Distribution Companies in Nigeria with coverage, tariffs, and contacts
/api/v1/utilities/electricity/discos/:code
Full details for a specific electricity distribution company
/api/v1/utilities/electricity/discos/:code/tariffs
Electricity tariff classes and rates for a distribution company
/api/v1/utilities/electricity/discos/:code/coverage
Coverage areas and states served by a distribution company
/api/v1/utilities/electricity/discos/:code/payment-channels
Payment channels and methods for electricity bills
/api/v1/utilities/electricity/discos/:code/meters
Meter types and specifications for a distribution company
/api/v1/utilities/electricity/calculate
Calculate estimated electricity bill based on consumption
/api/v1/utilities/cable-tv
Cable TV providers (DSTV, GOtv, StarTimes) with subscription plans and channels
/api/v1/utilities/cable-tv/:provider
Subscription plans and pricing for a cable TV provider
/api/v1/utilities/gas
Nigerian gas distribution and supply companies
/api/v1/utilities/gas/lpg-prices
Current LPG (cooking gas) prices by weight across Nigerian cities
/api/v1/utilities/gas/:provider
Details for a specific gas provider
/api/v1/utilities/water
State water corporations and supply authorities
/api/v1/utilities/water/:corp
Details for a specific water corporation
/api/v1/utilities/stats
Aggregate statistics for Nigerian utility sectors
/api/v1/insurance/providers
Nigerian insurance companies with products, ratings, and financial strength
/api/v1/insurance/providers/:code
Full details for a specific insurance company
/api/v1/insurance/providers/:code/products
Product listing for a specific insurance company
/api/v1/insurance/motor/types
Types of motor vehicle insurance (Third Party, TPFT, Comprehensive) with descriptions
/api/v1/insurance/motor/quote
Calculate motor insurance premium based on vehicle value and coverage type
/api/v1/insurance/health
Health insurance plans by HMO providers
/api/v1/insurance/health/:provider
Health insurance plans for a specific HMO
/api/v1/insurance/nhis
National Health Insurance Scheme information and coverage
/api/v1/insurance/naicom
National Insurance Commission regulatory information
/api/v1/insurance/stats
Nigerian insurance sector statistics and market data
/api/v1/employment/salaries
Salary ranges by role across Nigerian industries
/api/v1/employment/salaries/sectors
Average salary data grouped by industry sector
/api/v1/employment/salaries/sectors/:sector
Salary ranges for roles within a specific sector
/api/v1/employment/salaries/:role
Detailed salary information for a specific job role
/api/v1/employment/minimum-wage
Current national minimum wage and history of adjustments
/api/v1/employment/labor-laws
Summary of Nigerian labor laws covering employment terms, leave, and termination
/api/v1/employment/employers
Major employers in Nigeria with employee count, sector, and benefits
/api/v1/employment/employers/:name
Details for a specific employer
/api/v1/employment/job-boards
Nigerian job search platforms and career websites
/api/v1/employment/job-boards/:name
Details for a specific job search platform
/api/v1/employment/stats
Nigerian employment sector statistics including unemployment rate
/api/v1/realestate/prices
Property prices by area including rent, purchase, and land prices
/api/v1/realestate/prices/:city
Property prices for a specific city or area
/api/v1/realestate/mortgage/providers
Nigerian mortgage banks and housing finance institutions
/api/v1/realestate/mortgage/providers/:name
Details for a specific mortgage provider
/api/v1/realestate/mortgage/calculate
Calculate monthly mortgage payment, total interest, and amortization
/api/v1/realestate/stats
Nigerian real estate market statistics
/api/v1/transport/fuel-prices
Current fuel prices in Nigeria (PMS, AGO, DPK, aviation fuel)
/api/v1/transport/vehicle-registration
Vehicle registration fees by category (private, commercial, government)
/api/v1/transport/ride-hailing
Ride-hailing services operating in Nigeria with coverage and pricing
/api/v1/transport/ride-hailing/:service
Details for a specific ride-hailing service
/api/v1/transport/stats
Nigerian transport sector statistics
/api/v1/agriculture/commodities
Nigerian agricultural commodity prices (rice, maize, beans, yam, cassava, etc.)
/api/v1/agriculture/commodities/:name
Current price for a specific agricultural commodity
/api/v1/agriculture/stats
Nigerian agriculture sector statistics
/api/v1/business/company-types
CAC company registration types and requirements
/api/v1/business/company-types/:type
Requirements and details for a specific company type
/api/v1/business/cac-fees
Corporate Affairs Commission registration and filing fees
/api/v1/business/stock-exchange
Nigerian Exchange Group (NGX) information and market overview
/api/v1/business/stocks
Stocks listed on the Nigerian Exchange with prices, market cap, and sector
/api/v1/business/stocks/:ticker
Price and details for a specific listed stock
/api/v1/business/stats
Nigerian business environment statistics
/api/v1/legal/court-fees
Court filing fees by court level (Magistrate, High Court, Appeal, Supreme)
/api/v1/legal/services
Standard legal service fees for common services
/api/v1/legal/summary
Complete overview of legal costs in Nigeria
/api/v1/cost-of-living
Cost of living data by Nigerian city including housing, food, transport, and utilities
/api/v1/cost-of-living/:city
Detailed cost breakdown for a specific city
/api/v1/cost-of-living/:city/compare
Compare cost of living between two Nigerian cities
Free tier: 1,000 requests/month. No credit card needed.
1,000/mo requests
50,000/mo requests
1,000,000/mo requests
Get your API key
Enter your email above to get a free key instantly. No credit card required.
Add the header
Authorization: Bearer cx_your_api_key_here
Make requests
All endpoints return JSON. Base URL: https://comparex.kelthos.com/api/v1
https://comparex.kelthos.com/api/v1