Driving Licence Number Check

Compatible Cases

About this 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.

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

Example Request

{
    "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:

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

Example Response with errors

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

{
    "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:

{
    "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:

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

Docs not making sense? Please contact us so we can fix them: [email protected] :)