Driving Licence Verification API
Check that a driving licence is real, current and covers the vehicles your driver will drive, in one call.
The documentation opens in the VerifyAll dashboard after sign-in, for accounts with approved API access. New to the API? Start with the developer guide.
Overview
What the Driving Licence Verification API does
The Driving Licence Verification API takes a licence number and the holder’s date of birth and answers with the licence on record: the holder’s name, father’s or husband’s name, date of birth and blood group, the licence status (for example active, expired or suspended), the issue date, validity for non-transport and transport vehicles, the classes of vehicle it covers with the date each was added, the address and the office that first issued it.
The licence is found by number and date of birth together. Send the name your customer gave and name_match compares it with the holder’s name, with a score from 0 to 100. The answer also carries the latest endorsement on the licence and, where they apply, the validity of hazardous-goods and hill-driving authorisations.
For any business that puts someone behind the wheel, a valid licence for the right class of vehicle is the first condition. Checking it at onboarding, and again before it lapses, keeps expired, suspended and borrowed licences off your roster.
How it works
- 1
Your server sends POST /universal/dl-verification with the licence number as printed, the date of birth, the consent object and, if you have it, the name to compare.
- 2
The request is checked first: a licence number in the wrong shape, a malformed date or a missing consent object is refused with every problem listed before anything runs or is charged.
- 3
The licence number and date of birth are checked against live records and the answer comes back in the same call, usually within about 10 seconds.
- 4
The result is stored in your VerifyAll account with a checkResultId; read it again, find it by your client_ref or download the PDF report.
Request and response
Driving licence verification API endpoints and fields
The main fields; the full reference with every field, error code and a cURL sample is in the dashboard docs.
| Endpoint | What it does |
|---|---|
| POST/universal/dl-verification | Verify a driving licence by number and date of birth |
Request fields
| Field | What it is |
|---|---|
| licence_numberRequired | The licence number as printed: state code, two-digit office code and the number, with or without hyphens or spaces (for example DL-0120221234567). |
| dobRequired | The holder’s date of birth, YYYY-MM-DD; used with the number to find the licence. |
| consentRequired | obtained: true and a purpose of up to 200 characters, for the licence holder. |
| nameOptional | The name your customer gave; sets name_match. |
| client_refOptional | Your own reference, stored with the result (up to 100 characters). |
What the answer returns
| Field | What it is |
|---|---|
| name / relation_name | The holder’s name, and the father’s or husband’s name as printed. |
| name_match | exact, partial, mismatch or not_checked, with a score from 0 to 100. |
| dob / blood_group | Date of birth and blood group on record. |
| status | Licence status in lower case, for example active, expired or suspended. |
| issued_on / validity | Issue date, and validity until for non-transport vehicles and from and until for transport vehicles. |
| vehicle_classes | Each class of vehicle the licence covers (LMV, MCWG, TRANS and so on), with its description and the date it was issued. |
| address / issuing_authority | The address on the licence, and the office that first issued it. |
| last_endorsement | The latest change recorded on the licence: date, office and reason. |
| hazardous_valid_until / hill_valid_until | Validity of hazardous-goods and hill-driving authorisations, where they apply. |
Base URL https://api.verifyall.ai. Authenticate with the X-API-Key header (a va_sandbox_ or va_live_ key). Every answer carries data, status_code, success, message and message_code; checks add outcome, checkResultId, charged and charged_amount.
Key features
Driving Licence Verification API features and capabilities
Vehicle classes, not just a yes
vehicle_classes lists every class the licence covers, so you can confirm that a delivery rider holds MCWG or a cab driver holds a transport class.
Separate transport validity
validity gives non-transport and transport dates apart, which matters for commercial drivers whose transport endorsement lapses sooner.
Status and endorsements
The status and the last endorsement show a suspended or changed licence that a photo of the card would not.
Name and date-of-birth match
The date of birth is part of the lookup, and name_match scores the name your customer gave from 0 to 100.
Use cases
Where businesses use the Driving Licence Verification API
Driver and rider onboarding
Verify the licence of every delivery rider, cab driver or logistics driver before the first trip, and check the class matches the vehicle.
Vehicle rental and car sharing
Confirm the renter holds a current licence for the vehicle type at booking or pick-up.
Motor insurance
Check the driver’s licence status and class at proposal or when a claim is made.
Periodic re-checks
Re-run the check before validity dates pass to find drivers whose licence has expired or been suspended since onboarding.
Industries
Coverage
Driving licences issued in India, found by licence number and date of birth. Licences issued outside India and international driving permits are not covered.
Limitations to plan for
- The licence number and date of birth must both match; a correct number with the wrong date of birth answers record_not_found, which is charged because the lookup ran.
- Older licences may have fields the record does not hold, such as blood group or address; those come back as null, never guessed.
- The API does not read a photo of the licence. Ask for the number and date of birth in your form.
- Checks about a person need the consent object, and you keep the consent record.
Integration
How to integrate the Driving Licence Verification API
From a business account to your first live call.
Step 1
Create a business account on VerifyAll and get it approved, as for running checks in the dashboard.
Step 2
Request Developer API access under Developers in the dashboard: the APIs you need, your expected monthly volume and your use case. The VerifyAll team reviews it and shares the API Services Agreement.
Step 3
Once the agreement is signed and access is approved, create your Sandbox key and build against sample data. Sandbox calls are never charged.
Step 4
Create your Production key, recharge your wallet and switch the key in your code: the endpoint and fields stay the same.
Get started
Request access to the Driving Licence Verification API
Tell us what you want to verify. We reply within one business day with access steps, Sandbox details and your API pricing.
View API documentation
The full reference for Driving Licence Verification API (endpoints, fields, errors, cURL) opens in the dashboard once your access is approved.
Open the docs (sign-in)Create a business account
API keys are issued to an approved business account. Sign up, then request access under Developers.
Create account
Pricing
Production calls are charged per check from your prepaid VerifyAll wallet, at your account’s API price; GST is added separately when you recharge. Sandbox calls are never charged. Your API prices are shown in the dashboard once access is approved. How pricing works
Already have a business account? Sign in to request access
Driving Licence Verification API: frequently asked questions
Answers for teams planning an integration.
Still have questions? Our team is happy to help.
Contact SupportRelated APIs
RC + Challan Verification API
LiveInstant answerSend a registration number and get the RC details, validity dates, finance and permit status and the vehicle’s challans in one answer.
View API detailsBackground Verification API
LiveFinishes laterRun the background checks you choose on one person in a single request, and read back one report with an overall result and every check’s outcome.
View API detailsPAN Verification API
LiveInstant answerConfirm a PAN exists, see who holds it and match the name and date of birth your customer typed, in one call.
View API detailsVoter ID Verification API
LiveInstant answerConfirm a voter ID card is genuine and see the name, relative, age and address on record, in one call.
View API details
All identity verification APIsRun Driving licence verification in the dashboard, without codeBrowse the API Marketplace
Start with the Driving Licence Verification API
Request access, build against the Sandbox, then go live with your Production key.