> ## 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 Driver's Licence

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

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/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 parameters

| Parameter          | Type   | Description               | Required |
| ------------------ | ------ | ------------------------- | -------- |
| license\_number \* | string | A driver's license number | required |

### Sample response

```json Response theme={null}
{
    "entity": {
        "uuid": "1625583696",
        "licenseNo": "FKJ494A2133",
        "firstName": "JOHN",
        "lastName": "MUSA",
        "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 (YYYY-MM-DD)                 |
| entity.expiryDate   | string | Expiry date of the licence (YYYY-MM-DD)                  |
| entity.stateOfIssue | string | State where the licence was issued                       |
| entity.birthDate    | string | Date of birth of the licence holder (DD-MM-YYYY)         |
| 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`