VNIN

Verify your customers’ identities using their Virtual National Identity Number (VNIN)

Leverage Adhere’s VNIN verification endpoint to securely retrieve and validate customer details using their Virtual National Identification Number (VNIN).

Request Endpoint

POST {{BASE_URL}}/api/onboarding/nigeria_kyc/vnin/

Status Codes

• 200 OK: The request was successful, and the VNIN details are returned successfully.
• 400 Bad Request: The request could not be completed due to invalid or missing information.

Sample Payload

{
  "vnin": "AB012345678910YZ"
}

200 OK Response

{
  "status": "success",
  "data": {
    "vnin": "AB012345678910YZ",
    "firstname": "John",
    "middlename": "Doe",
    "lastname": "Alamutu",
    "gender": "M",
    "mobile": "08012345678",
    "photo": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQICAQECAQEBAgICAgICAgICAQICA9GXNN69zjdrF0+7aps5Xn0TqWf=",
    "customer": "6bb82c41-e15e-4308-b99d-e9640818eca9"
  },
  "message": "Virtual National Identification Number details retrieved successfully"
}

400 Bad Request Response

{
  "status": "failed",
  "data": [],
  "message": "VNIN is required"
}