Introduction

POST /v1/natural/drivers-license endpoint will return information about the driver’s license validity and expiration date.

Authentication

An access token must be included in the request to access the API.

You can obtain an access token by following the instructions provided here.

Environment	Swagger URL	API URL	Endpoint	Scope

Environment	Swagger URL	API URL	Endpoint	Scope
Sandbox	Swagger UI	`https://sandbox-registries.ondato.com`	POST `/v1/natural/drivers-license`	registries_driverslicense_writeonly
Production	Swagger UI	`https://registries.ondato.com`	POST `/v1/natural/drivers-license`	registries_driverslicense_writeonly

To perform a driver’s license check, you need to make a POST request to the /v1/natural/drivers-license endpoint.

Parameter	Type	Required	Description

Parameter

Type

Required

Description

Correlation-Id

string

no

A unique identifier assigned to the request.

Application-Id

string

YES

Your application Id.

Please contact support@ondato.com you don’t have one.

Access token

string

YES

Described in the Authentication part

Field	Description

Field	Description
`country`	Driver license issuing country. Supported countries: LT (Lithuania) LV (Latvia) EE (Estonia) JM (Jamaica) PL (Poland)
`firstName`	First name of the drivers licenses' owner.
`lastName`	Last name of the drivers licenses' owner.
`personalCode`	Personal code of the drivers licenses' owner.
`documentNumber`	The unique number of the driver license.