> ## 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.

# Permis de conduire

> Vérifiez l'identité d'un client à l'aide de son numéro de permis de conduire nigérian.

<Warning>
  Ce service n'est pas disponible actuellement. Nous travaillons à le restaurer — veuillez consulter à nouveau bientôt.
</Warning>

L'endpoint Permis de conduire récupère les informations d'identité vérifiées depuis la base de données FRSC, incluant le nom, la date de naissance, les dates de validité du permis, l'État de délivrance et une photo.

## Endpoint

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

## Requête

### En-têtes

| En-tête          | Valeur                | Requis |
| ---------------- | --------------------- | ------ |
| `x-access-token` | Votre clé secrète API | Oui    |
| `Content-Type`   | `application/json`    | Oui    |

### Paramètres de corps

| Paramètre        | Type   | Requis | Description                                     |
| ---------------- | ------ | ------ | ----------------------------------------------- |
| `license_number` | string | Oui    | Le numéro de permis de conduire du client       |
| `first_name`     | string | Oui    | Prénom tel qu'il apparaît sur le permis         |
| `last_name`      | string | Oui    | Nom de famille tel qu'il apparaît sur le permis |
| `date_of_birth`  | string | Oui    | Date de naissance au format `YYYY-MM-DD`        |

### Exemple

<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>

## Réponse

### 200 OK

| Champ               | Type   | Description                       |
| ------------------- | ------ | --------------------------------- |
| `data.licenseNo`    | string | Numéro de permis                  |
| `data.lastName`     | string | Nom de famille                    |
| `data.firstName`    | string | Prénom                            |
| `data.middleName`   | string | Deuxième prénom                   |
| `data.gender`       | string | Genre                             |
| `data.dateOfBirth`  | string | Date de naissance                 |
| `data.issuedDate`   | string | Date de délivrance du permis      |
| `data.expiryDate`   | string | Date d'expiration du permis       |
| `data.stateOfIssue` | string | État où le permis a été délivré   |
| `data.image`        | string | Photo du permis encodée en base64 |

```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: Document Verification
  - 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
                - first_name
                - last_name
                - date_of_birth
              properties:
                license_number:
                  type: string
                  description: Driver's license number
                  example: ARR10892UU00
                first_name:
                  type: string
                  description: First name as on the license
                  example: EDIKAN
                last_name:
                  type: string
                  description: Last name as on the license
                  example: EFE
                date_of_birth:
                  type: string
                  description: Date of birth in YYYY-MM-DD format
                  example: '1994-08-11'
      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

````