Driver License Verification

info

The Driver License Verification API confirms the validity of a driver's license and returns its associated details.

1.0 Authorization

This API requires an access token. To get more info on how to generate this access token, click on Generating Access Token

2.0 Base Url

All requests to the Driver License Verification API must be done using the web API URL below.

Test Environment: https://api-devapps.vfdbank.systems/vtech-kyc/api/v2/kyc

Live Environment: https://api-apps.vfdbank.systems/vtech-kyc/api/v2/kyc

3.0 How To Use The Driver License Verification API

1. The developer should call the Driver License Verification API

3.1 Driver License Verification

API Context : /driver-license/verification

This endpoint confirms if a driver's license is valid and returns the information on it.

API METHOD: POST

REQUEST HEADERS

Key	Value
AccessToken	{{token}}

Sample Request

 {
   "firstName": "Andrew",
   "lastName": "Doe",
   "gender": "male",
   "dob": "1960-10-31",
   "idNumber": "FFF39140AA98"
  }

Request Field Description

Field	Description	Status
firstName	Customer's first name	Mandatory
lastName	Customer's last name	Mandatory
gender	Customer's gender	Mandatory
dob	Customer's dob e.g 1960-10-02 (Must be in this date format)	Mandatory
idNumber	Customer's driver licence number	Mandatory

Sample Responses

{
    "status": "00",
    "message": "Successful",
    "data": {
        "valid": true,
        "idNumber": "FFF39140AA98",
        "gender": "male",
        "fullName": "Andrew Smith Doe",
        "firstName": "Andrew",
        "lastName": "Doe",
        "middleName": "Smith",
        "dateOfBirth": "1960-10-31",
        "residentialAddress": "13, Newton Street, Ikeja, Lagos",
        "expiryDate": "27-11-2027",
        "photo": "base64 image string",
        "stateOfOrigin": "",
        "stateOfResidence": "",
        "watchListed": "",
        "levelOfAccount": "",
        "nationality": "",
        "enrolmentBank": "",
        "enrolmentBranch": "",
        "registrationDate": "",
        "nin": "",
        "available": true,
        "firstNameMatch": true,
        "lastNameMatch": true,
        "dobMatch": true
    }
}

note

In the test environment, you should use the payload below

  {
   "firstName": "Andrew",
   "lastName": "Doe",
   "gender": "male",
   "dob": "1960-10-31",
   "idNumber": "FFF39140AA98"
  }