DEVELOPER HUBv1.2.0 API SPECIFICATION

Verixa ID Developer Platform

Unified, usage-based identity verification, KYB, biometric face match, and telecom APIs built for African fintechs and high-growth platforms. Engineered with 100% Dojah architecture parity and sub-15ms Smart Identity Caching.

Dojah 1:1 Parity

Drop-in endpoint taxonomy (/api/v1/kyc/...), headers (AppId + Authorization), and JSON envelope.

Smart Identity Cache

Sub-15ms cached lookups with 60% automated fee reduction on repeat queries within your tenant partition.

Prepaid NGX Metering

Predictable per-call usage deductions from your organization wallet. Zero hidden subscription overheads.

Active API Endpoints & Usage Rates

Standard rates across live government registries and 60% discounted Smart Cache hits.

100% DOJAH PARITYSUB-15MS CACHE
1. Identity & Government KYC Lookups
GET
BVN Validation (Match Details)/api/v1/kyc/bvn?bvn=...
₦95.00/ ₦38.00 cache
GET
BVN Full Lookup/api/v1/kyc/bvn/full?bvn=...
₦95.00/ ₦38.00 cache
GET
BVN Advance (Branch & Account Level)/api/v1/kyc/bvn/advance?bvn=...
₦125.00/ ₦50.00 cache
POST
BVN + Selfie Facial Verification/api/v1/kyc/bvn/verify
₦150.00/ ₦60.00 cache
GET
NIN Basic Lookup/api/v1/kyc/nin?nin=...
₦125.00/ ₦50.00 cache
GET
NIN Advance (Photo, Address & Next-of-Kin)/api/v1/kyc/nin/advance?nin=...
₦125.00/ ₦50.00 cache
GET
NIN Premium Profile/api/v1/kyc/nin/premium?nin=...
₦125.00/ ₦50.00 cache
GET
NIN Slip Record/api/v1/kyc/nin/nin_slip?nin=...
₦150.00/ ₦60.00 cache
POST
NIN + Selfie Facial Verification/api/v1/kyc/nin/verify
₦150.00/ ₦60.00 cache
GET
Phone Number Basic Lookup/api/v1/kyc/phone_number/basic?phone_number=...
₦50.00/ ₦20.00 cache
GET
Phone Carrier & Demographics/api/v1/kyc/phone_number?phone_number=...
₦95.00/ ₦38.00 cache
2. Banking Intelligence & NUBAN
GET
NUBAN Account Name Resolve/api/v1/kyc/account?account_number=...&bank_code=...
Free (₦0.00)
GET
NUBAN Tier & KYC Level Status/api/v1/kyc/nuban/status?account_number=...&bank_code=...
₦35.00/ ₦14.00 cache
3. Corporate Affairs & Business KYB (CAC & TIN)
GET
CAC Basic Company Lookup/api/v1/kyc/cac/basic?rc_number=...&company_type=...
₦120.00/ ₦48.00 cache
GET
CAC Advance (Directors, Shareholders & Shares)/api/v1/kyc/cac/advance?rc_number=...&company_type=...
₦250.00/ ₦100.00 cache
GET
TIN Tax ID Verification (JTB / FIRS)/api/v1/kyc/tin?tin=...
₦90.00/ ₦36.00 cache
4. Secondary Government IDs (FRSC / INEC / NIS)
GET
Driver's License (FRSC)/api/v1/kyc/dl?license_number=...&dob=...
₦95.00/ ₦38.00 cache
GET
Voter's Card (VIN / INEC)/api/v1/kyc/vin?vin=...&state=...&last_name=...
₦80.00/ ₦32.00 cache
GET
International Passport (NIS)/api/v1/kyc/passport?passport_number=...&last_name=...&dob=...
₦150.00/ ₦60.00 cache
5. Biometrics, Anti-Fraud & Compliance Screening
POST
Photo ID Face Match & Liveness/api/v1/kyc/photoid/verify
₦120.00/ ₦48.00 cache
POST
AML, PEP & Sanctions Screening/api/v1/aml/screening
₦150.00/ ₦60.00 cache
GET
Multi-Bureau Credit Score/api/v1/credit/bvn?bvn=...
₦250.00/ ₦100.00 cache
GET
Email Risk & Deliverability Intelligence/api/v1/kyc/email?email=...
₦30.00/ ₦12.00 cache

5-Minute Quickstart

Verixa implements Dojah-compatible authentication headers. Obtain your Sandbox or Live credentials from your Console dashboard and include your secret key in the Authorization header (with or without the Bearer prefix) alongside your AppId.

Making your first BVN lookup (Dojah Parity)
curl -X GET "https://api.verixaid.com/api/v1/kyc/bvn?bvn=22123456789&first_name=CHIDERA" \
-H "Authorization: vrx_live_9f83a8f1e2b4c6d8_a1b2c3d4..." \
-H "AppId: app_6a7b8c9d0e1f" \
-H "Content-Type: application/json"
Standardized JSON Response
HTTP 200 OK
{
"status": "success",
"entity": {
"bvn": "22123456789",
"first_name": "CHIDERA",
"last_name": "OLUTOLA",
"date_of_birth": "1988-04-14",
"phone_number1": "08039218492",
"gender": "Male"
},
"billed_amount": 50,
"cached": false,
"meta": {
"request_id": "vx_req_8f19a02d",
"service": "bvn",
"latency_ms": 142,
"environment": "live"
}
}