Driving License Check
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
. Furthermore, the provided document 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
clientId
string
The ID of the client associated with this check. (Required)
type
string
This must be set to multi_bureau_check
. (Required)
documentId
string
The ID of the document. (Required)
Example requests
Simple request
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"
}'
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:
clear
: Indicates sufficient client attributes are successfully matched against bureaus, and hence the client's identity is verified.attention
: Indicates that at least one of the client attributes is only partially matched, or none were matched at all, requiring attention.
Breakdown
The breakdown comprises the following objects:
documentData
object
documentData
objectThe 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
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 inYYYY-MM-DD
format.expirationDate
: The date the entitlement expires inYYYY-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 akey
,value
, anddescription
.
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:
clear
: Indicates the analysis returned a successful result.attention
: Indicates a potential falsified or fraudulent document.
licenseVerification
object
licenseVerification
objectThe 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.offenseLegalDescription
: A legal description of the offence.offenseDate
: The date the offence occurred inYYYY-MM-DD
format.penaltyPoints
: The number of penalty points applied to the licence as a result of the offence.
clientDataConsistency
object
clientDataConsistency
objectThe 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"
}
Last updated
Was this helpful?