Skip to main content
POST
Driving licence verification

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer <your-key>.

Body

application/json

The driving licence to verify, and the holder details to hold it to.

number
string
required

Driving licence number in letters and digits alone, without spaces or hyphens, like MH1420110062821

Pattern: ^[A-Z]{2}[A-Z0-9]{8,18}$
date_of_birth
string<date>
required

The holder's date of birth. It cannot be after today

issue_date
string<date> | null

The date the licence was issued. Where given, it is verified as well. It cannot be after today, or before the date of birth

Response

Successful Response

What the registry holds for a driving licence, and whether the claimed details matched.

details is null when the registry holds no licence under the number.

A licence the registry holds whose details matched but that has passed its expiry date answers driving-licence-expired, with the licence alongside.

reasons
Reason · object[]

Why the check did not pass, worst first, each a stable code with the text for it. Empty when it passed

details
DrivingLicenceVerification · object | null

The registry's record of the licence