API Status

Driving Licence Number Check

Verifies an individual's driving licence

Log in to see full request history

Compatible Cases

Icon 1

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.

Property NameTypeOptional/MandatoryNotes
DrivingLicenceNumberstringMandatory
SurnamestringOptional
DayOfBirthintegerOptional
MonthOfBirthintegerOptional
YearOfBirthintegerOptional'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

"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: support@w2globaldata.com :)

Query Params
string
required
Defaults to 1.5

API version to use

Body Params
string
required

The bundle of services to call

string

A unique reference for the call

Data
object
required
Options
object

These are optional parameters for some extra fields not covered in the Data object. Use this section to set Sandbox mode as well as to add search filters on alerts.

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json