Lookup Ghana Driver's License

Verify a Ghanaian driver’s licence and fetch holder details from the licensing authority.

[GET]

{{baseUrl}}/api/v1/gh/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 parameter

Parameter	Type	Description	Required
id *	string	The Voter Number, Application ID, or National ID Number (NIN)	required
full_name *	string	The full name of the document holder	required
date_of_birth*	string	The date of birth of the document holder in the format yyyy-MM-DD	required

Sample response

Response

{
    "entity": {
        "certificate_date": "2010-07-19",
        "date_of_birth": "1988-09-01",
        "expiry_date": "2016-08-25",
        "full_name": "John Doe",
        "id": "V1234567",
        "is_date_of_birth_match": true,
        "is_full_name_match": true,
        "issue_date": "2010-08-25",
        "picture": "/9j/4AAQSkZJRgABAQAAAQABA",
        "pin": "DOE-310203-03-01",
        "processing_center": "VR3"
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the verification response data
entity.certificate_date	string	Date the driving certificate was issued (yyyy-MM-dd)
entity.date_of_birth	string	Date of birth of the individual (yyyy-MM-dd)
entity.expiry_date	string	Expiry date of the driver’s license (yyyy-MM-dd)
entity.full_name	string	Full name of the license holder
entity.id	string	Driver’s license ID number
entity.is_date_of_birth_match	boolean	Whether the provided date of birth matches the record
entity.is_full_name_match	boolean	Whether the provided name matches the record
entity.issue_date	string	Date the license was issued (yyyy-MM-dd)
entity.picture	string	Base64-encoded photo of the individual
entity.pin	string	Personal identification number associated with the license
entity.processing_center	string	Center where the license was processed