ID Check UK Driving Licence Number
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 Name | Type | Length | Optional/Mandatory | Notes |
---|---|---|---|---|
DrivingLicenceNumber | String | Mandatory | ||
Surname | String | Optional | ||
DayOfBirth | Int | Optional | ||
MonthOfBirth | Int | Optional | ||
YearOfBirth | Int | Optional | "yyyy" |
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
If the number is not recognised you might see a response like this:
"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"
}