ID Check UK Driving Licence Number service

ID Check UK Driving Licence Number service

IDCheckUKDrivingLicenceNumberService is a driving licence verification service. It checks that the validity of the driving licence number, and checks the driving licence number against any additional supplied optional parameters.

Properties

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.

Request

The following is an example SOAP request.

<QueryData>                   
<DrivingLicenceNumber>RUSSF802087TG9EV11</DrivingLicenceNumber> </QueryData>

Response

<IDCheckUKDrivingLicenceNumberResult>
<!-- Errors found on the entered driving licence number, if any. --> <ValidationErrors/> </IDCheckUKDrivingLicenceNumberResult>

For example if the number is not recognised you might see a response like this:

<IDCheckUKDrivingLicenceNumberResult>
  <ValidationErrors>
    <string>Licence number is not 18 characters</string>
  </ValidationErrors>
</IDCheckUKDrivingLicenceNumberResult>

Sandbox

This service uses Sandbox V2.

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

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

 

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

 

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