Driving License Check

Driving License Check API for KYC driving license verification, entitlement and penalty data retrieval, and fraud detection.

Run a driving license check

To run a Driving License Check, you must create a check with type set to driving_license_check.

This check can only be performed on a client of type person.

The documentId provided must meet the following conditions:

• It must be of type driving_license.
• It must include a valid documentNumber, which represents the driving licence number.

Learn more about Driving License Checks.

Check request

Attribute	Type	Description
clientId	string	The ID of the client associated with this check. (Required)
type	string	This must be set to driving_license_check. (Required)
documentId	string	The ID of the document. (Required)

Example requests

Simple request

cURL

curl -X POST https://api.complycube.com/v1/checks \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
          "clientId":"CLIENT_ID",
          "documentId":"DOCUMENT_ID",
          "type": "driving_license_check"
        }'

Node.js

const check = await complycube.check.create("CLIENT_ID", {
        documentId: "DOCUMENT_ID",
        type: "driving_license_check"
});

Python

check = cc_api.check.create(
    'CLIENT_ID', 
    'driving_license_check', 
    documentId='DOCUMENT_ID'
)

PHP

$result = $ccapi->checks()->create('CLIENT_ID',
                                   ['type' => 'driving_license_check',
                                   'documentId' => 'DOCUMENT_ID']);

.NET

var checkRequest = new CheckRequest {
  clientId = "CLIENT_ID",
  documentId = "DOCUMENT_ID",
  type = "driving_license_check"
};

var check = await checkApi.CreateAsync(checkRequest);

Result object

The result object is only returned when the status of the check is complete . It has two components - outcome and breakdown.

Outcome

The outcome attribute represents the overall check result. Returned values include:

1. clear: Indicates every analysis type conducted returned a successful result.
2. attention: Indicates at least one of the analysis results requires attention.

Breakdown

The breakdown comprises the following objects:

documentData object

This represents the data retrieved from the issuing authority. It has the following constituents:

• documentDetails: Data relating to the driving license.

  • licenseType: The detected driving license type. Values include full and provisional.
  • issuingCountry: The issuing country of the document. This will be the two-letter country ISO code.
  • expirationDate: The expiry date of the driving license. This will be a structured date.
  • documentNumber: The driving license number.
  • points: The number of active penalty points currently associated with the driving license.
  • issuingDate: The issuing date of the driving license. This will be a structured date.
  • entitlements: An array of driving entitlements associated with the licence. Each object represents a specific category or class of vehicle the licence holder is permitted to drive. It includes:

    • code: The entitlement category code.
    • description: A detailed explanation of the entitlement.
    • type: The type of entitlement (e.g. full, provisional).
    • issuingDate: The date the entitlement was issued in YYYY-MM-DD format.
    • expirationDate: The date the entitlement expires in YYYY-MM-DD format.
    • restrictions: A list of restriction codes and their descriptions that apply to the entitlement.
  • additionalDetails: Any additional retrieved details, returned as an array of objects. Each object will contain a key, value, and description.
• holderDetails : Data relating to the driving license holder.

  • firstName: The list of first/given names as an array.
  • lastName: The list of last names as an array.
  • dob: The date of birth. This will be a structured date.
  • nationality: The nationality. This will be the two-letter country ISO code.
  • gender: The gender. Values include:

    • male
    • female
    • other
  • address : This will be the structured address, which includes the following:

    • propertyNumber: The property number.
    • line: The address line.
    • city: The address city.
    • state: The address state.
    • postalCode: The address postal code.
    • country: The address country. This will be the two-letter country ISO code.

Analysis

For each conducted analysis, the returned values include:

1. clear: Indicates the analysis returned a successful result.
2. attention: Indicates the analysis returned a result that requires a review.

licenseVerification object

The driving license verification results. It has the following constituents:

• status: Indicates whether the license has an active status.
• infractions: Indicates whether the license has any recorded infractions.
• breakdown: Breakdown related to license verification.

  • infractionsBreakdown: An array detailing recorded infractions associated with the driving licence. Each entry includes:

    • offenseCode: The official code assigned to the offence.
    • offenseDate: The date the offence occurred in YYYY-MM-DD format.
    • offenseLegalDescription: A legal description of the offence.
    • penaltyPoints: The number of penalty points applied to the licence as a result of the offence.
    • penaltyPointsExpiryDate: The date the penalty points expire, in YYYY-MM-DD format.
    • convictionDate: The date the offence was convicted by the court,

      in YYYY-MM-DD format.
    • sentenceDate: The date the sentence was imposed by the court,

      in YYYY-MM-DD format.
    • disqualification: The driving disqualification details, including:

      • months: The duration of the disqualification in months.
      • startDate: The date the disqualification period begins, in YYYY-MM-DD format.

clientDataConsistency object

The client data consistency results. It has the following constituents::

• name: Indicates whether the client provided name matches the one retrieved.
• dob: Indicates whether the client’s provided date of birth matches the one retrieved.
• nationality: Indicates whether the client’s provided nationality matches the one retrieved.
• address: Indicates whether any of the client provided addresses match the one retrieved.

Sample Response

{
    "id": "688f1e2e37d2a9000202ad7f",
    "entityName": "John Doe",
    "type": "driving_license_check",
    "clientId": "688f1e2e37d2a9000202ad70",
    "documentId": "688f1e2e37d2a9000202ad76",
    "status": "complete",
    "result": {
        "outcome": "attention",
        "breakdown": {
            "clientDataConsistency": {
                "name": "clear",
                "dob": "clear",
                "nationality": "clear",
                "gender": "clear",
                "address": "clear"
            },
            "licenseVerification": {
                "status": "clear",
                "infractions": "attention",
                "breakdown": {
                    "infractionsBreakdown": [
                        {
                            "offenseCode": "SP30",
                            "offenseLegalDescription": "Exceeding statutory speed limit on a public road",
                            "offenseDate": "2018-04-28",
                            "penaltyPoints": 3
                        }
                    ]
                }
            },
            "documentData": {
                "holderDetails": {
                    "firstName": [
                        "John",
                        "Johnson"
                    ],
                    "lastName": [
                        "Smith"
                    ],
                    "dob": {
                        "day": 31,
                        "month": 1,
                        "year": 1990
                    },
                    "nationality": "GB",
                    "gender": "male",
                    "address": {
                        "propertyNumber": "123",
                        "line": "Main road",
                        "city": "City",
                        "postalCode": "WC1H 0PW",
                        "country": "GB"
                    }
                },
                "documentDetails": {
                    "issuingCountry": "GB",
                    "licenseType": "full",
                    "issuingDate": {
                        "day": 6,
                        "month": 7,
                        "year": 2020
                    },
                    "expirationDate": {
                        "day": 5,
                        "month": 7,
                        "year": 2030
                    },
                    "documentNumber": "JOHNSO101099JJ7FM",
                    "points": "3",
                    "additionalDetails": [
                        {
                            "key": "lgvValidTo",
                            "value": "2019-12-31",
                            "description": "LGV license expiry"
                        },
                        {
                            "key": "pcvValidTo",
                            "value": "2019-12-31",
                            "description": "PCV license expiry"
                        },
                        {
                            "key": "dqcIssueDate",
                            "value": "2019-12-31",
                            "description": "DQC issue date"
                        }
                    ],
                    "entitlements": [
                        {
                            "code": "A",
                            "description": "A motorcycle of a power exceeding 35 kW or with a power to weight ratio exceeding 0.2 kW per kg, or A motorcycle of a power not exceeding 35 kW with a power to weight ratio not exceeding 0.2 kW per kg and derived from a vehicle of more than double its power. A motor tricycle with a power exceeding 15 kW",
                            "type": "full",
                            "issuingDate": "2013-01-19",
                            "expirationDate": "2037-10-25",
                            "restrictions": [
                                {
                                    "code": "79(03)",
                                    "description": "Restricted to tricycles"
                                }
                            ]
                        }
                    ]
                }
            }
        }
    },
    "updatedAt": "2025-01-01T08:30:40.334Z",
    "createdAt": "2025-01-01T08:30:38.527Z"
}