Nigeria BVN Verification

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
PreProduction
Production
curl --location 'https://api.signzy.app/api/v3/global-kyc-verify/ng/bvn' \
--header 'Authorization: <----auth Token----->' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstName": "Abu",
    "lastName": "Salim",
    "middleName": "Damu",
    "dateOfBirth": "1968-10-18",
    "gender": "Male",
    "phoneNumber": "8079374852",
    "identityInformation": {
        "nationalIdNumber": "22253395872"
    },
    "consent": true
}'
curl --location 'https://api.signzy.app/api/v3/global-kyc-verify/ng/bvn' \
--header 'Authorization: <----auth Token----->' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstName": "Abu",
    "lastName": "Salim",
    "middleName": "Damu",
    "dateOfBirth": "1968-10-18",
    "gender": "Male",
    "phoneNumber": "8079374852",
    "identityInformation": {
        "nationalIdNumber": "22253395872"
    },
    "consent": true
}'
﻿
Request Body Parameters
Parameter
Type
Description
Required/Optional
firstName
String
First Name  of the person
Required
lastName
String
Last Name of the person
Required
middleName
String
Middle Name of the person
Optional
dateOfBirth
String
Date of birth of the person in yyyy-mm-dd format
Required
gender
String
gender of the person Male/Female
Optional
phoneNumber
String
Phone Number associated with the inidividual
Optional
nationalIdNumber
String
13 Digit national Id number
Required
consent
Boolean
Consent of the end user for verification of his/her data
Required
Response
JSON
{
    "result": {
        "verificationResult": {
            "firstName": true,
            "middleName": true,
            "lastName": true,
            "dateOfBirth": true,
            "gender": true,
            "phoneNumber": true,
            "nationalIdNumber": true
        }
    }
}
{
    "result": {
        "verificationResult": {
            "firstName": true,
            "middleName": true,
            "lastName": true,
            "dateOfBirth": true,
            "gender": true,
            "phoneNumber": true,
            "nationalIdNumber": true
        }
    }
}
﻿
Response Body Parameters
Parameter
Description
Data Type
firstName
The API returns a Boolean value ("True" for a match found and "False" for no match found).
boolean
middleName
The API returns a Boolean value ("True" for a match found and "False" for no match found).
boolean
lastName
The API returns a Boolean value ("True" for a match found and "False" for no match found).
boolean
dateOfBirth
The API returns a Boolean value ("True" for a match found and "False" for no match found).
boolean
gender
The API returns a Boolean value ("True" for a match found and "False" for no match found).
boolean
phoneNumber
The API returns a Boolean value ("True" for a match found and "False" for no match found).
boolean
nationaIdNumber
The API returns a Boolean value ("True" for a match found and "False" for no match found).
boolean
Error Code and Response Mapping
400 (Bad Request)
401(Unauthorized)
403 (Forbidden)
500 (Internal Server Error)
409(Upstream Down
{
  "error": {
     "name": "error",
     "message": "Bad Input and description ",
     "status": 400,
     "reason": "VALIDATION_ERROR",
     "type": "Bad Request",
     "statusCode": 400
  }
}
{
  "error": {
     "name": "error",
     "message": "Bad Input and description ",
     "status": 400,
     "reason": "VALIDATION_ERROR",
     "type": "Bad Request",
     "statusCode": 400
  }
}
﻿
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!
﻿

Parameter	Type	Description	Required/Optional
firstName	String	First Name of the person	Required
lastName	String	Last Name of the person	Required
middleName	String	Middle Name of the person	Optional
dateOfBirth	String	Date of birth of the person in yyyy-mm-dd format	Required
gender	String	gender of the person Male/Female	Optional
phoneNumber	String	Phone Number associated with the inidividual	Optional
nationalIdNumber	String	13 Digit national Id number	Required
consent	Boolean	Consent of the end user for verification of his/her data	Required

Parameter	Description	Data Type
firstName	The API returns a Boolean value ("True" for a match found and "False" for no match found).	boolean
middleName	The API returns a Boolean value ("True" for a match found and "False" for no match found).	boolean
lastName	The API returns a Boolean value ("True" for a match found and "False" for no match found).	boolean
dateOfBirth	The API returns a Boolean value ("True" for a match found and "False" for no match found).	boolean
gender	The API returns a Boolean value ("True" for a match found and "False" for no match found).	boolean
phoneNumber	The API returns a Boolean value ("True" for a match found and "False" for no match found).	boolean
nationaIdNumber	The API returns a Boolean value ("True" for a match found and "False" for no match found).	boolean

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.

Did this page help you?

Nigeria NIN Verification

Nigeria Driver's Licence Verification