The full driving licence number to be enquired upon including the check digits. Options are available to include CPC and tachograph data and to accept/reject partial responses (when unexpected techncial problems prevent CPC or tachograph data from being retrieved for the enquiry).
Success. Return a combination of driver, tachograph and cpc data
{"driver":{"drivingLicenceNumber":"TCAEU610267NO9EK","firstNames":"NPBPG OYOT","lastName":"TCAEUCJ","gender":"Male","dateOfBirth":"1967-10-26","address":{"unstructuredAddress":{"line1":"78 A TEST DATA DO NOT DELIVER","line5":"GREAT YARMOUTH","postcode":"NR30 4BH"}}},"licence":{"type":"Full","status":"Valid"},"entitlement":[{"categoryCode":"A","categoryLegalLiteral":"A motorcycle of a power exceeding 35 kW or with a power to weight ratio exceeding 0.2 kW per kg, or A motorcycle of a power not exceeding 35 kW with a power to weight ratio not exceeding 0.2 kW per kg and derived from a vehicle of more than double its power. A motor tricycle with a power exceeding 15 kW","categoryType":"Full","fromDate":"2013-01-19","expiryDate":"2037-10-25","restrictions":[{"restrictionCode":"79(03)","restrictionLiteral":"Restricted to tricycles"}]}],"endorsements":[{"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2018-04-28","penaltyPoints":3}],"token":{"validFromDate":"1999-04-11","validToDate":"2037-10-25","issueNumber":"69"}}
{"driver":{"drivingLicenceNumber":"LQZVJ603206B99ZY","firstNames":"BKNTPL","lastName":"LQZVJMTJ","gender":"Male","dateOfBirth":"1966-03-20","address":{"unstructuredAddress":{"line1":"02 B TEST DATA DO NOT DELIVER","line5":"LIVERPOOL","postcode":"L8 0SW"}},"disqualifiedForLife":true},"licence":{"type":"Full","status":"Disqualified","statusQualifier":"For life"},"endorsements":[{"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2017-07-04","penaltyPoints":3},{"offenceCode":"SP50","offenceLegalLiteral":"Exceeding speed limit on a motorway","offenceDate":"2017-08-19","penaltyPoints":3},{"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2018-05-01","penaltyPoints":3},{"disqualification":{"forLife":true},"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2022-12-21","convictionDate":"2023-01-01"}],"entitlement":[{"categoryCode":"B1","categoryLegalLiteral":"Motor vehicles with 4 wheels up to 400 kg unladen or 550 kg if they're designed for carrying goods","categoryType":"Full","fromDate":"1991-06-18","expiryDate":"2023-01-01"}],"token":{"validFromDate":"1991-07-03","validToDate":"2036-03-19","issueNumber":"94"}}
{"driver":{"drivingLicenceNumber":"NDSRZ904116AN9CN","firstNames":"AOE NRKT","lastName":"N'HVCTN","gender":"Male","dateOfBirth":"1996-04-11","address":{"unstructuredAddress":{"line1":"941 TEST DATA DO NOT DELIVER","line5":"BIRMINGHAM","postcode":"B25 8SN"}},"disqualifiedPendingSentence":true},"licence":{"type":"Full","status":"Disqualified","statusQualifier":"Pending sentence"},"entitlement":[{"categoryCode":"C","categoryLegalLiteral":"Vehicles weighing over 3,500 kg (with a trailer up to 750 kg), with no more than 8 passengers and driver","categoryType":"Full","fromDate":"2015-07-08","expiryDate":"2019-01-21"}],"endorsements":[{"offenceCode":"DD10","offenceLegalLiteral":"Causing serious injury by dangerous driving","offenceDate":"2017-12-15","convictionDate":"2019-01-21"}],"token":{"validFromDate":"2016-03-18","validToDate":"2020-08-03","issueNumber":"21"}}
{"driver":{"drivingLicenceNumber":"BBUWI604072H99JF","firstNames":"HZFW","lastName":"BBUWIQUZD","gender":"Male","dateOfBirth":"1962-04-07","address":{"unstructuredAddress":{"line1":"9 PH TEST DATA DO NOT DELIVER","line5":"WHITLEY BAY","postcode":"NE26 3P"}}},"licence":{"type":"Provisional","status":"Valid"},"entitlement":[{"categoryCode":"C1","categoryLegalLiteral":"Vehicles weighing between 3,500 and 7,500 kg (with a trailer up to 750 kg), with no more than 8 passengers and driver","categoryType":"Provisional","fromDate":"1984-03-21","expiryDate":"2032-04-06"}],"endorsements":[],"token":{"validFromDate":"1984-03-21","validToDate":"2032-04-06","issueNumber":"33"}}
{"driver":{"drivingLicenceNumber":"AFEBL412082FW9CT","lastName":"AFEBL","gender":"Male","firstNames":"FOXBRJG WKVT O","dateOfBirth":"1942-12-08","address":{"unstructuredAddress":{"line1":"57 G TEST DATA DO NOT DELIVER","line2":"RUMNEY","line5":"CARDIFF","postcode":"CF3 3LX"}}},"licence":{"type":"Full","status":"Valid"},"endorsements":[{"penaltyPoints":3,"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2016-07-07"}],"entitlement":[{"categoryCode":"B","categoryLegalLiteral":"Vehicles up to 3,500 kg Maximum Authorised Mass (MAM) with up to 8 passenger seats and driver (with a trailer up to 750 kg). Can also tow heavier trailers if the total weight of vehicle and trailer isn't more than 3,500 kg. Physically disabled drivers with provisional category B entitlement will also have provisional entitlement to ride category A1 or A motor tricycles. Able-bodied drivers can no longer ride motor tricycles with a provisional category B licence","categoryType":"Full","fromDate":"1975-07-15","expiryDate":"2021-12-07","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}],"token":{"issueNumber":"01","validFromDate":"2018-10-11","validToDate":"2021-12-07"},"cpc":{"cpcs":[{"lgvValidTo":"2023-03-27","pcvValidTo":"2022-06-09"}]},"dqc":{"dqcs":[{"issueDate":"2019-05-04"}]},"holder":{"tachoCards":[{"cardNumber":"DB08311162038002","cardStatus":"DISPATCHED","cardExpiryDate":"2028-03-01","cardStartOfValidityDate":"2023-03-02"}]}}
{"driver":{"drivingLicenceNumber":"AFEBL412082FW9CT","lastName":"AFEBL","gender":"Male","firstNames":"FOXBRJG WKVT O","dateOfBirth":"1942-12-08","address":{"unstructuredAddress":{"line1":"57 G TEST DATA DO NOT DELIVER","line2":"RUMNEY","line5":"CARDIFF","postcode":"CF3 3LX"}}},"licence":{"type":"Full","status":"Valid"},"endorsements":[{"penaltyPoints":3,"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2016-07-07"}],"entitlement":[{"categoryCode":"B","categoryLegalLiteral":"Vehicles up to 3,500 kg Maximum Authorised Mass (MAM) with up to 8 passenger seats and driver (with a trailer up to 750 kg). Can also tow heavier trailers if the total weight of vehicle and trailer isn't more than 3,500 kg. Physically disabled drivers with provisional category B entitlement will also have provisional entitlement to ride category A1 or A motor tricycles. Able-bodied drivers can no longer ride motor tricycles with a provisional category B licence","categoryType":"Full","fromDate":"1975-07-15","expiryDate":"2021-12-07","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}],"token":{"issueNumber":"01","validFromDate":"2018-10-11","validToDate":"2021-12-07"},"cpc":{"cpcs":[{"lgvValidTo":"2023-03-27","pcvValidTo":"2022-06-09"}]},"dqc":{"dqcs":[{"issueDate":"2019-05-04"}]}}
{"driver":{"drivingLicenceNumber":"AFEBL412082FW9CT","lastName":"AFEBL","gender":"Male","firstNames":"FOXBRJG WKVT O","dateOfBirth":"1942-12-08","address":{"unstructuredAddress":{"line1":"57 G TEST DATA DO NOT DELIVER","line2":"RUMNEY","line5":"CARDIFF","postcode":"CF3 3LX"}}},"licence":{"type":"Full","status":"Valid"},"endorsements":[{"penaltyPoints":3,"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2016-07-07"}],"entitlement":[{"categoryCode":"B","categoryLegalLiteral":"Vehicles up to 3,500 kg Maximum Authorised Mass (MAM) with up to 8 passenger seats and driver (with a trailer up to 750 kg). Can also tow heavier trailers if the total weight of vehicle and trailer isn't more than 3,500 kg. Physically disabled drivers with provisional category B entitlement will also have provisional entitlement to ride category A1 or A motor tricycles. Able-bodied drivers can no longer ride motor tricycles with a provisional category B licence","categoryType":"Full","fromDate":"1975-07-15","expiryDate":"2021-12-07","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}],"token":{"issueNumber":"01","validFromDate":"2018-10-11","validToDate":"2021-12-07"},"holder":{"tachoCards":[{"cardNumber":"DB08311162038002","cardStatus":"DISPATCHED","cardExpiryDate":"2028-03-01","cardStartOfValidityDate":"2023-03-02"}]}}
{"driver":{"drivingLicenceNumber":"AFEBL412082FW9CT","lastName":"AFEBL","gender":"Male","firstNames":"FOXBRJG WKVT O","dateOfBirth":"1942-12-08","address":{"unstructuredAddress":{"line1":"57 G TEST DATA DO NOT DELIVER","line2":"RUMNEY","line5":"CARDIFF","postcode":"CF3 3LX"}}},"licence":{"type":"Full","status":"Valid"},"endorsements":[{"penaltyPoints":3,"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2016-07-07"}],"entitlement":[{"categoryCode":"B","categoryLegalLiteral":"Vehicles up to 3,500 kg Maximum Authorised Mass (MAM) with up to 8 passenger seats and driver (with a trailer up to 750 kg). Can also tow heavier trailers if the total weight of vehicle and trailer isn't more than 3,500 kg. Physically disabled drivers with provisional category B entitlement will also have provisional entitlement to ride category A1 or A motor tricycles. Able-bodied drivers can no longer ride motor tricycles with a provisional category B licence","categoryType":"Full","fromDate":"1975-07-15","expiryDate":"2021-12-07","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}],"token":{"issueNumber":"01","validFromDate":"2018-10-11","validToDate":"2021-12-07"},"errors":[{"status":"503","code":"ENQ068","detail":"CPC data currently unavailable"},{"status":"503","code":"ENQ069","detail":"Tachograph data currently unavailable"}]}
{"driver":{"drivingLicenceNumber":"AFEBL412082FW9CT","lastName":"AFEBL","gender":"Male","firstNames":"FOXBRJG WKVT O","dateOfBirth":"1942-12-08","address":{"unstructuredAddress":{"line1":"57 G TEST DATA DO NOT DELIVER","line2":"RUMNEY","line5":"CARDIFF","postcode":"CF3 3LX"}}},"licence":{"type":"Full","status":"Valid"},"endorsements":[{"penaltyPoints":3,"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2016-07-07"}],"entitlement":[{"categoryCode":"B","categoryLegalLiteral":"Vehicles up to 3,500 kg Maximum Authorised Mass (MAM) with up to 8 passenger seats and driver (with a trailer up to 750 kg). Can also tow heavier trailers if the total weight of vehicle and trailer isn't more than 3,500 kg. Physically disabled drivers with provisional category B entitlement will also have provisional entitlement to ride category A1 or A motor tricycles. Able-bodied drivers can no longer ride motor tricycles with a provisional category B licence","categoryType":"Full","fromDate":"1975-07-15","expiryDate":"2021-12-07","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}],"token":{"issueNumber":"01","validFromDate":"2018-10-11","validToDate":"2021-12-07"},"holder":{"tachoCards":[{"cardNumber":"DB08311162038002","cardStatus":"DISPATCHED","cardExpiryDate":"2028-03-01","cardStartOfValidityDate":"2023-03-02"}]},"errors":[{"status":"503","code":"ENQ068","detail":"CPC data currently unavailable"}]}
{"driver":{"drivingLicenceNumber":"AFEBL412082FW9CT","lastName":"AFEBL","gender":"Male","firstNames":"FOXBRJG WKVT O","dateOfBirth":"1942-12-08","address":{"unstructuredAddress":{"line1":"57 G TEST DATA DO NOT DELIVER","line2":"RUMNEY","line5":"CARDIFF","postcode":"CF3 3LX"}}},"licence":{"type":"Full","status":"Valid"},"endorsements":[{"penaltyPoints":3,"offenceCode":"SP30","offenceLegalLiteral":"Exceeding statutory speed limit on a public road","offenceDate":"2016-07-07"}],"entitlement":[{"categoryCode":"B","categoryLegalLiteral":"Vehicles up to 3,500 kg Maximum Authorised Mass (MAM) with up to 8 passenger seats and driver (with a trailer up to 750 kg). Can also tow heavier trailers if the total weight of vehicle and trailer isn't more than 3,500 kg. Physically disabled drivers with provisional category B entitlement will also have provisional entitlement to ride category A1 or A motor tricycles. Able-bodied drivers can no longer ride motor tricycles with a provisional category B licence","categoryType":"Full","fromDate":"1975-07-15","expiryDate":"2021-12-07","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}],"token":{"issueNumber":"01","validFromDate":"2018-10-11","validToDate":"2021-12-07"},"cpc":{"cpcs":[{"lgvValidTo":"2023-03-27","pcvValidTo":"2022-06-09"}]},"dqc":{"dqcs":[{"issueDate":"2019-05-04"}]},"errors":[{"status":"503","code":"ENQ069","detail":"Tachograph data currently unavailable"}]}
{"errors":[{"code":"ENQ068","detail":"CPC data currently unavailable","status":"503"},{"code":"ENQ069","detail":"Tachograph data currently unavailable","status":"503"}]}
{"errors":[{"code":"ENQ068","detail":"CPC data currently unavailable","status":"503"}]}
{"errors":[{"code":"ENQ069","detail":"Tachograph data currently unavailable","status":"503"}]}
Optional enum to indicate whether to accept a partial response. ‘true’ permits a partial to be returned in all cases, ‘false’ returns an error response if any of the requested data is unavailable, ‘onConditionCPCAvailable’ permits a partial response only when cpc data is available and ‘onConditionTachoAvailable’ permits a partial response only when tachograph data is available. This field defaults to ‘false’.
viewDriverResponse
{"driver":{"drivingLicenceNumber":"ABCDE123456AB1AB","firstNames":"JOHN","lastName":"DOE","gender":"Male","dateOfBirth":"2019-12-31","address":{"unstructuredAddress":{"line1":"5 HIGH STREET","line2":"GARNET","line3":"AMMANFORD","line4":"CARMARTHENSHIRE","line5":"WALES","postcode":"SA18 1AB"}},"disqualifiedUntil":"2019-12-31","disqualifiedForLife":true,"disqualifiedPendingSentence":true},"licence":{"type":"Provisional","status":"Valid","statusQualifier":"For re-assessment only"},"entitlement":[{"categoryCode":"A1","categoryLegalLiteral":"Motorbikes with engine size up to 125 cc, power output up to 11 kW and power/weight ratio up to 0.1 kW/kg","categoryType":"Provisional","fromDate":"2019-12-31","expiryDate":"2019-12-31","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}],"endorsements":[{"disqualification":{"type":"string","forLife":true,"years":3,"months":1,"days":1},"offenceCode":"DD30","offenceLegalLiteral":"string","offenceDate":"2019-12-31","convictionDate":"2019-12-31","penaltyPoints":0}],"token":{"validFromDate":"2019-12-31","validToDate":"2019-12-31","issueNumber":"string"},"cpc":{"cpcs":[{"lgvValidTo":"2019-12-31","pcvValidTo":"2019-12-31"}]},"dqc":{"dqcs":[{"issueDate":"2019-12-31"}]},"holder":{"tachoCards":[{"cardNumber":"string","cardStatus":"string","cardExpiryDate":"2019-12-31","cardStartOfValidityDate":"2019-12-31"}]},"errors":[{"status":"string","code":"string","detail":"string"}]}
Pattern: ^[a-zA-Z0-9]*$ Min length: 5 Max length: 16
A UK driving licence number
includeCPC
true
Optional boolean indicating whether to return CPC data. Defaults to false.
Properties
Name
Type
Required
Restrictions
Description
anonymous
boolean
false
none
Optional boolean indicating whether to return CPC data. Defaults to false.
includeTacho
true
Optional boolean indicating whether to return tachograph data. Defaults to false.
Properties
Name
Type
Required
Restrictions
Description
anonymous
boolean
false
none
Optional boolean indicating whether to return tachograph data. Defaults to false.
acceptPartialResponse
"true"
Optional enum to indicate whether to accept a partial response. ‘true’ permits a partial to be returned in all cases, ‘false’ returns an error response if any of the requested data is unavailable, ‘onConditionCPCAvailable’ permits a partial response only when cpc data is available and ‘onConditionTachoAvailable’ permits a partial response only when tachograph data is available. This field defaults to ‘false’.
Optional enum to indicate whether to accept a partial response. ‘true’ permits a partial to be returned in all cases, ‘false’ returns an error response if any of the requested data is unavailable, ‘onConditionCPCAvailable’ permits a partial response only when cpc data is available and ‘onConditionTachoAvailable’ permits a partial response only when tachograph data is available. This field defaults to ‘false’.
Enumerated Values
Property
Value
anonymous
true
anonymous
false
anonymous
onConditionCPCAvailable
anonymous
onConditionTachoAvailable
driver
{"drivingLicenceNumber":"ABCDE123456AB1AB","firstNames":"JOHN","lastName":"DOE","gender":"Male","dateOfBirth":"2019-12-31","address":{"unstructuredAddress":{"line1":"5 HIGH STREET","line2":"GARNET","line3":"AMMANFORD","line4":"CARMARTHENSHIRE","line5":"WALES","postcode":"SA18 1AB"}},"disqualifiedUntil":"2019-12-31","disqualifiedForLife":true,"disqualifiedPendingSentence":true}
Information or restrictions relating to the status of a licence
entitlementRecord
{"categoryCode":"A1","categoryLegalLiteral":"Motorbikes with engine size up to 125 cc, power output up to 11 kW and power/weight ratio up to 0.1 kW/kg","categoryType":"Provisional","fromDate":"2019-12-31","expiryDate":"2019-12-31","restrictions":[{"restrictionCode":"01","restrictionLiteral":"Eyesight Correction"}]}
Information or restrictions relating to the status of a licence
Properties
Name
Type
Required
Restrictions
Description
anonymous
string
false
Enum: For re-assessment only,Photo licence invitation sent,Short period disqualification,Until test passed,Until extended test passed,Pending sentence,For life
Information or restrictions relating to the status of a licence
Enumerated Values
Property
Value
anonymous
For re-assessment only
anonymous
Photo licence invitation sent
anonymous
Short period disqualification
anonymous
Until test passed
anonymous
Until extended test passed
anonymous
Pending sentence
anonymous
For life
categoryCode
"A1"
Licence category code
Properties
Name
Type
Required
Restrictions
Description
anonymous
string
false
none
Licence category code
categoryLegalLiteral
"Motorbikes with engine size up to 125 cc, power output up to 11 kW and power/weight ratio up to 0.1 kW/kg"