---
title: "Changes to Returns driver data for the supplied driving licence number, including licence details. Optionally returns CPC and tachograph data"
method: POST
path: "/v1/driving-licences/retrieve"
---

# Changes to Returns driver data for the supplied driving licence number, including licence details. Optionally returns CPC and tachograph data

`POST /v1/driving-licences/retrieve`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 6 revisions.

- **2026-07-23** `058f2a402660`: 3 warning
- **2025-07-05** `c472dc3f1697`: 6 warning, 17 info
- **2025-02-22** `16c82c7243d3`: 1 warning, 1 info
- **2023-12-03** `aca20c9524ae`: 3 info

## Changes

- **2026-07-23** `058f2a402660`: 3 warning
  - added the new `Appeal against Disqualification until Extended Test Pass` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the new `Appeal against Disqualification until Test Pass` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the new `Appeal against Revocation until Test Pass` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
- **2025-07-05** `c472dc3f1697`: 6 warning, 17 info
  - added the new `Disqualified until Extended Test Pass` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the new `Disqualified until Test Pass` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the new `Extended test passed` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the new `Revoked test passed` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the new `Revoked until Test Pass` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the new `Test passed` enum value to the `endorsements/items/disqualification/type` response property for the response status `200`
  - added the optional property `endorsements/items/disqualification/disqualifiedPendingSentence` to the response with the `200` status
  - added the optional property `endorsements/items/disqualification/startDate` to the response with the `200` status
  - added the optional property `endorsements/items/disqualificationReimposedDate` to the response with the `200` status
  - added the optional property `endorsements/items/disqualificationRemovalDate` to the response with the `200` status
  - added the optional property `endorsements/items/disqualificationSuspendedPendingAppealDate` to the response with the `200` status
  - added the optional property `endorsements/items/penaltyPointsExpiryDate` to the response with the `200` status
  - added the optional property `errors/items/title` to the response with the `200` status
  - added the optional property `errors/items/title` to the response with the `400` status
  - added the optional property `errors/items/title` to the response with the `401` status
  - added the optional property `errors/items/title` to the response with the `403` status
  - added the optional property `errors/items/title` to the response with the `404` status
  - added the optional property `errors/items/title` to the response with the `429` status
  - added the optional property `errors/items/title` to the response with the `500` status
  - added the optional property `errors/items/title` to the response with the `502` status
  - added the optional property `errors/items/title` to the response with the `503` status
  - added the optional property `errors/items/title` to the response with the `504` status
  - response property `endorsements/items/disqualifiedPendingSentence` deprecated
- **2025-02-22** `16c82c7243d3`: 1 warning, 1 info
  - removed the optional property `dqc` from the response with the `200` status
  - added the optional property `cpc/cpcs/items/national` to the response with the `200` status
- **2023-12-03** `aca20c9524ae`: 3 info
  - added the optional property `endorsements/items/disqualifiedPendingSentence` to the response with the `200` status
  - added the optional property `endorsements/items/sentenceDate` to the response with the `200` status
  - added the optional property `testPass` to the response with the `200` status

---

[Operation](https://skmtc.dev/driver-and-vehicle-licensing-age/apis/driver-view-external/docs/v1/driving-licences/retrieve/post.md) - [API](https://skmtc.dev/driver-and-vehicle-licensing-age/apis/driver-view-external.md) - [Page](https://skmtc.dev/driver-and-vehicle-licensing-age/apis/driver-view-external/changes/v1/driving-licences/retrieve/post)