🇳🇬 Nigeria
Nigeria Bank Verification Number (BVN)
Verifies input data against the Nigerian Banking Industry database. Authoritative real-time identity lookup for Nigeria. Real-time lookup, pay-per-call.
POST
Verifies input data against the Nigerian Banking Industry database. Didit exposes this service through
POST /v3/database-validation/ so you can verify the submitted data against the authoritative source and receive normalized match results.
Coverage
- Coverage: ~ 100%
- Country: Nigeria
- Service ID:
nga_bank_verification_number - Data domain: Financial
- Category: Banking
Inputs
- Required inputs:
first_name,last_name,bvn - Optional inputs:
date_of_birth,vendor_data - Consent: Not required
- Workflow availability: Standalone API only
- Coverage: ~ 100%
- Price: $0.80 per successful query
Body parameters
string
default:"NGA"
required
ISO 3166-1 alpha-3 country code for this database service.Example:
NGAstring
default:"nga_bank_verification_number"
required
Array containing this service ID. Pinning the service keeps the request scoped to this exact database.Example:
nga_bank_verification_numberstring
default:"John"
required
Given name to validate.Example:
Johnstring
default:"Doe"
required
Family name to validate.Example:
Doestring
default:"11111111111"
required
Bank Verification Number.Example:
11111111111string
default:"1990-01-01"
Date of birth in
YYYY-MM-DD format.Example: 1990-01-01string
default:"user-1234"
Your stable user reference for this person, such as your internal user ID. Didit uses it to link standalone checks to the same end user and reduce duplicate-detection noise.Example:
user-1234Input rules & validation notes
- Nigerian Bank Verification Number (exactly 11 digits)
bvnmust contain digits only; remove spaces, hyphens, and punctuation before sending the request.bvnmust be exactly 11 characters long.
How to call it
Returned data
The exact fields surfaced insource_data depend on what the registry returns. The generated example for nga_bank_verification_number currently documents this normalized shape:
date_of_birthfirst_namelast_name
Pricing & SLAs
Nigeria Bank Verification Number (BVN) queries are billed only when Didit receives a conclusive result from the validation source.- Per-call price: $0.80 USD.
- Billing: per successful query. You are not charged when the registry is unreachable, when required fields are missing, or when the request is rejected before reaching the source.
- Latency: typical p95 < 2 s.
- Availability: 99.9% per quarter on Didit’s side; downstream source availability varies by country and dataset.