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