Nigeria BVN Fetch

Overview

The Nigeria BVN Verification API allows organizations to verify an individual's identity details against the Bank Verification Number (BVN) database in Nigeria. This API is crucial for financial institutions, telecom companies, and other service providers that require accurate identity verification to comply with KYC (Know Your Customer) and AML (Anti-Money Laundering) regulations.

Use Case

KYC Compliance: Institutions perform BVN checks to comply with Know Your Customer (KYC) regulations, ensuring all customer data is verified and up-to-date.

Mobile Wallet Verification: Fintech companies offering mobile wallet services use the API to confirm user identities before activating their accounts, enhancing security measures.

Fraud Prevention: By confirming personal details with the BVN database, financial services can detect and prevent fraudulent activities, protecting both the institution and its customers.

Insurance Claim Processing: Insurance companies utilize BVN verification to authenticate the identity of claimants, reducing the risk of fraudulent claims.

API Details

Request Body

curl --location 'https://api.signzy.app/api/v3/global-kyc-fetch/ng/bvn' \
--header 'Authorization: <----auth Token----->' \
--header 'Content-Type: application/json' \
--data '{
    "bvn": ""
}'

Request Body Parameters

Parameter	Type	Description	Required/Optional
bvn	String	Bank Verification Number	Required

Response

{
    "result": {
        "bvn": "",
        "firstName": "",
        "middleName": "",
        "lastName": "",
        "dateOfBirth": "",
        "gender": "",
        "phoneNumber1": "",
        "phoneNumber2": "",
        "photo": ""
    }
}

Response Body Parameters

Parameter	Description	Data Type
bvn	The Bank Verification Number (BVN) of the individual. This is a unique 11-digit identification number.	string
firstName	The first name of the individual as registered with their BVN.	string
middleName	The middle name of the individual as registered with their BVN. This field may be empty if no middle name is provided.	string
lastName	The last name (surname) of the individual as registered with their BVN.	string
dateOfBirth	The date of birth of the individual in YYYY-MM-DD format.	string
gender	The gender of the individual. Possible values include Male or Female .	string
phoneNumber1	The primary phone number associated with the BVN.	string
phoneNumber2	A secondary phone number associated with the BVN.	string
photo	A persist URL pointing to the photograph of the individual associated with the BVN.	string

Error Code and Response Mapping

{
  "error": {
     "name": "error",
     "message": "Forbidden",
     "reason": "ERROR",
     "type": "Bad Request",
     "statusCode": "403"
  }
}

Field	Type	Description
name	string	Text displayed on the screen explaining error type.
reason	string	Reason for the error.
status	number	HTTP status code.
message	string	Error message indicating an upstream error.
type	string	Error type.
statusCode	number	Status code representing the error scenario.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!