> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lookup Ghana Driver's License

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

```http [GET] theme={null}
{{baseUrl}}/api/v1/gh/kyc/dl
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| 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

```json Response theme={null}
{
    "entity": {
        "certificate_date": "2010-07-19",
        "date_of_birth": "1988-09-01",
        "expiry_date": "2016-08-25",
        "full_name": "John Doe Musa",
        "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                     |