v1

latestOpenAPI 3.0.32026-07-14108241269.2 KB

Driving Licence v2

Driving Licence Verification v2

Verifies an Indian driving licence against the issuing RTO / Sarathi records using the customer's configured v2 verification setup. On a match, returns the holder's identity details, issuing authority, licence validity (transport and non-transport), authorised vehicle classes, and status.

Response contract: Every completed verification returns HTTP 200. A successful result returns status: "success" with error_code: null and a populated data object. A valid request with no matching record (or a business rejection) also returns HTTP 200 with status: "failed", a non-null error_code, and data: null. Do not treat HTTP 200 alone as success — always branch on status and inspect error_code. Authenticate with your X-Client-ID and X-API-KEY headers. Transport, auth, and validation problems use standard 4xx/5xx status codes.

post/v2/verify/driving_licence

Request body

licence_numberstring required

Driving licence number exactly as printed on the licence (RTO code + serial).

dobstring date required

Licence holder's date of birth in YYYY-MM-DD format.

Example request

{
  "licence_number": "UK0720180016135",
  "dob": "2000-06-09"
}

Response

Verification completed. Inspect status and error_code for the business result.

statusstring required

messagestring nullable

error_codestring nullable

tranx_idstring nullable

timestampstring nullable