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

# Driver's License

> Verify a customer's identity using their Nigerian driver's license number.

The Driver's License endpoint retrieves verified identity information from the FRSC database, including name, date of birth, license validity dates, state of issue, and a photo.

## Endpoint

```
POST /api/onboarding/nigeria_kyc/driver_license/
```

## Request

### Headers

| Header           | Value               | Required |
| ---------------- | ------------------- | -------- |
| `x-access-token` | Your API secret key | Yes      |
| `Content-Type`   | `application/json`  | Yes      |

### Body Parameters

| Parameter        | Type   | Required | Description                            |
| ---------------- | ------ | -------- | -------------------------------------- |
| `license_number` | string | Yes      | The customer's driver's license number |
| `first_name`     | string | Yes      | First name as on the license           |
| `last_name`      | string | Yes      | Last name as on the license            |
| `date_of_birth`  | string | Yes      | Date of birth in `YYYY-MM-DD` format   |

### Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/driver_license/" \
    -H "x-access-token: YOUR_SECRET_KEY" \
    -H "Content-Type: application/json" \
    -d '{"license_number": "ARR10892UU00", "first_name": "EDIKAN", "last_name": "EFE", "date_of_birth": "1994-08-11"}'
  ```

  ```python Python theme={null}
  import requests
  response = requests.post(
      "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/driver_license/",
      headers={"x-access-token": "YOUR_SECRET_KEY", "Content-Type": "application/json"},
      json={"license_number": "ARR10892UU00", "first_name": "EDIKAN", "last_name": "EFE", "date_of_birth": "1994-08-11"},
  )
  ```
</CodeGroup>

## Response

### 200 OK

| Field               | Type   | Description                    |
| ------------------- | ------ | ------------------------------ |
| `data.licenseNo`    | string | License number                 |
| `data.lastName`     | string | Last name                      |
| `data.firstName`    | string | First name                     |
| `data.middleName`   | string | Middle name                    |
| `data.gender`       | string | Gender                         |
| `data.dateOfBirth`  | string | Date of birth                  |
| `data.issuedDate`   | string | License issue date             |
| `data.expiryDate`   | string | License expiry date            |
| `data.stateOfIssue` | string | State where license was issued |
| `data.image`        | string | Base64-encoded license photo   |

```json theme={null}
{
  "status": "success",
  "data": {
    "licenseNo": "ARR10892UU00",
    "lastName": "EDIKAN",
    "firstName": "EFE",
    "middleName": "MUNACHI",
    "gender": "male",
    "issuedDate": "2013-10-28",
    "expiryDate": "2018-11-28",
    "stateOfIssue": "OYO",
    "dateOfBirth": "1994-08-11",
    "image": "<base64-encoded-jpeg>"
  },
  "message": "Driver License details retrieved successfully"
}
```

### 400 Bad Request

```json theme={null}
{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}
```

### 401 Unauthorized

```json theme={null}
{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}
```


## OpenAPI

````yaml POST /api/onboarding/nigeria_kyc/driver_license/
openapi: 3.0.3
info:
  title: Adhere API
  description: >-
    Identity verification, credit checks, transaction monitoring, and loan fraud
    detection across Africa.
  version: 3.0.0
servers:
  - url: https://adhere-api.smartcomply.com
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Nigeria KYC
  - name: Kenya KYC
  - name: Ghana KYC
  - name: Rwanda KYC
  - name: Uganda KYC
  - name: Biometrics
  - name: Individual Credit
  - name: Business Credit
  - name: Transaction Monitoring
  - name: Transaction Screening
  - name: Transaction KYC
  - name: Loan Fraud
  - name: User Journey
paths:
  /api/onboarding/nigeria_kyc/driver_license/:
    post:
      tags:
        - Nigeria KYC
      summary: Driver's License
      operationId: driverLicense
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - license_number
              properties:
                license_number:
                  type: string
                  description: Driver's license number
                  example: AAA00000AA00
      responses:
        '200':
          description: Driver's license verified
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              data:
                type: array
                items: {}
              message:
                type: string
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              message:
                type: string
                example: Authentication credentials were not provided.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-access-token
      description: Your Adhere API secret key

````