Skip to content
On this page

ID Check UK Driving Licence Number ​

Compatible Cases

About the service ​

ID Check UK Driving Licence Number service ID Check UK Driving Licence Number service. IDCheckUKDrivingLicenceNumberService is a driving licence verification service. It checks the validity of the driving licence number, and checks the driving licence number against any additional supplied optional parameters.

Product Code: W2-DATA-DRIVING_LICENCE_NUMBER-UK-024

Does this service leave a credit search Footprint? No

Request ​

The following properties pertain to this service.

Property NameTypeLengthOptional/MandatoryNotes
DrivingLicenceNumberStringMandatory
SurnameStringOptional
DayOfBirthIntOptional
MonthOfBirthIntOptional
YearOfBirthIntOptional"yyyy"

After performing the search, the validation result (pass, fail, etc.) will be part of the TransactionInformation returned for the service call.

Example Request ​

json
{
    "Bundle": "KYC_UKDrivingLicenceMRZ",
    "Data": {
        "DrivingLicenceNumber":"RUSSF802087TG9EV11"
    },
    "Options": {
        "Sandbox": "true"
    },
    "ClientReference": "your-client-reference"
}

Response ​

Example Response ​

A number with no errors will appear like this:

json
"idCheckUKDrivingLicenceNumberResult": {
	"validationErrors": []
}

Example Response with errors ​

If the number is not recognised you might see a response like this:

json
"idCheckUKDrivingLicenceNumberResult": {
  "validationErrors": [
    "Licence number is not 18 characters"
  ]
}

Sandbox ​

If the Sandbox query option is set to "true" the following entry will be returned in the ServiceResult:

Example 1 ​

If the DrivingLicenceNumber is entered as "RUSSE801087WJ9EV11" then IDCheckUKDrivingLicenceNumberResult will contain an empty, non-null ValidationErrors.

The corresponding ServiceTransactions will show the following properties:

json
{
    "HaltTriggered": "False",
    "ServiceTransactionResult": "Success",
    "ServiceInterpretResult": "Pass",
    "ServiceTransactionResultMessage": "This call was generated using sandbox mode",
    "ValidationResult": "NotApplicable"
}

Example 2 ​

If the DrivingLicenceNumber is entered as any other 18 character string then ValidationErrors will contain the error "Check digits are invalid".

The corresponding ServiceTransactions will show the following properties:

json
{
    "HaltTriggered": "False",
    "ServiceTransactionResult": "Success",
    "ServiceInterpretResult": "Inconclusive",
    "ServiceTransactionResultMessage": "This call was generated using sandbox mode",
    "ValidationResult": "NotApplicable"
}

Example 3 ​

If the DrivingLicenceNumber is entered as any other string, or null, then ValidationErrors will contain the error "Licence number is not 18 characters".

The corresponding ServiceTransactions will show the following properties:

json
{
    "HaltTriggered": "False",
    "ServiceTransactionResult": "Success",
    "ServiceInterpretResult": "Inconclusive",
    "ServiceTransactionResultMessage": "This call was generated using sandbox mode",
    "ValidationResult": "NotApplicable"
}