Lookup Driver's Licence

Verify a Nigerian driver’s licence and retrieve holder details from the licensing authority using the licence number.

Request

[GET]

{{baseUrl}}/api/v1/kyc/dl

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameters

Parameter	Type	Description	Required
license_number *	string	A driver’s license number	required

Sample response

Response

{
    "entity": {
        "uuid": "1625583696",
        "licenseNo": "FKJ494A2133",
        "firstName": "JOHN",
        "lastName": "DOE",
        "middleName": "",
        "gender": "Male",
        "issuedDate": "2019-01-25",
        "expiryDate": "2024-08-17",
        "stateOfIssue": "LAGOS",
        "birthDate": "28-09-1998",
        "photo": "BASE 64 IMAGE"
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the driver’s licence verification response data
entity.uuid	string	Unique identifier for the licence record
entity.licenseNo	string	Driver’s licence number
entity.firstName	string	First name of the licence holder
entity.lastName	string	Last name of the licence holder
entity.middleName	string	Middle name of the licence holder
entity.gender	string	Gender of the licence holder
entity.issuedDate	string	Date the licence was issued
entity.expiryDate	string	Expiry date of the licence
entity.stateOfIssue	string	State where the licence was issued
entity.birthDate	string	Date of birth of the licence holder
entity.photo	string	Base64-encoded photo of the licence holder

Test Credentials for Sandbox

Kindly use this Test Driver’s license number in sandbox Environment

DL = FKJ494A2133, FKJ49409AB13