Driving License Text and PDF

POST

Driving License Text and PDF API — An Indian driving licence returned both ways in a single call: the full licence record as JSON, and a pdf_url pointing at a ready-to-print government smart-card / A4 PDF of the same licence. Send the licence number and date of birth and receive the holder name, parent or spouse name, date of birth, sex, blood group, permanent and temporary addresses with PIN codes, issuing authority and its RTO code, state, issue and expiry dates for both non-transport and transport classes, the vehicle classes the licence authorises, and the holder photograph as base64 — plus the document link. Dates come back as ISO YYYY-MM-DD, and gender and vehicle_classes are published from stable value sets, so both the shape and the values of this response are guaranteed not to move. pdf_url is an empty string in the rare case where a document could not be produced; the record itself is unaffected, so check it before following the link. Generated documents stay downloadable for a limited time — fetch and store the file promptly rather than holding the link. Use this endpoint when you need to both read the licence data and hand someone a printable card; the Driving License Verification and Driving License PDF endpoints sell those halves separately.

Coverage: India
Real-time general lookup
Structured JSON response
POST request with Bearer auth

Get API Key — Free View Full Docs

Endpoint

POST

https://app.way2api.com/api/v1/driving-license/text-pdf

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters

Parameter	Type	Required	Description
`dl_number`	string	Yes	Driving license number (10-20 characters, e.g. MH0320140001234). Case-insensitive, no spaces or hyphens.
`dob`	string	Yes	Date of birth of the license holder in dd/mm/yyyy format.

Request Example

<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/driving-license/text-pdf", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "dl_number" => "MH0320140001234", "dob" => "15/06/1992" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);

curl -X POST https://app.way2api.com/api/v1/driving-license/text-pdf \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"dl_number":"MH0320140001234","dob":"15/06/1992"}'

$.ajax({ url: "https://app.way2api.com/api/v1/driving-license/text-pdf", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "dl_number": "MH0320140001234", "dob": "15/06/1992" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });

const { data } = await axios.post( "https://app.way2api.com/api/v1/driving-license/text-pdf", {"dl_number":"MH0320140001234","dob":"15/06/1992"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);

import requests response = requests.post( "https://app.way2api.com/api/v1/driving-license/text-pdf", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "dl_number": "MH0320140001234", "dob": "15/06/1992" } ) print(response.status_code) print(response.json())

Response Example

200 OK Success Response

{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "license_number": "MH0320140001234",
            "state": "Maharashtra",
            "name": "PRIYA PATEL",
            "father_or_husband_name": "MAHESH PATEL",
            "dob": "1992-06-15",
            "gender": "F",
            "blood_group": "B+",
            "citizenship": "",
            "permanent_address": "42 MG ROAD, PUNE, MAHARASHTRA",
            "permanent_zip": "411001",
            "temporary_address": "42 MG ROAD, PUNE, MAHARASHTRA",
            "temporary_zip": "411001",
            "city_name": "PUNE",
            "ola_name": "RTO PUNE",
            "ola_code": "MH032",
            "doi": "2014-08-11",
            "doe": "2034-08-10",
            "initial_doi": "2014-08-11",
            "transport_doi": "1800-01-01",
            "transport_doe": "1800-01-01",
            "vehicle_classes": [
                "MCWG",
                "LMV-NT"
            ],
            "has_image": true,
            "profile_image": "/9j/4AAQSkZJRgABAQAAAQABAAD__gATQ3JlYXRlZCB3aXRoIEdJTVA...",
            "less_info": false,
            "pdf_url": "https://docs.example-renderer.com/upload/dl2_1786426531_70e7ff519ee00a12.pdf"
        }
    }
}

4xx Error Response

{
    "success": false,
    "message": "Verification Failed.",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "no_record",
        "result": {
            "license_number": "MH0320140001234",
            "state": "",
            "name": "",
            "father_or_husband_name": "",
            "dob": "1992-06-15",
            "gender": "",
            "blood_group": "",
            "citizenship": "",
            "permanent_address": "",
            "permanent_zip": "",
            "temporary_address": "",
            "temporary_zip": "",
            "city_name": null,
            "ola_name": "",
            "ola_code": "",
            "doi": "",
            "doe": "",
            "initial_doi": "",
            "transport_doi": "",
            "transport_doe": "",
            "vehicle_classes": [],
            "has_image": false,
            "profile_image": "",
            "less_info": false,
            "pdf_url": ""
        }
    }
}

Common Response Codes

Code	Meaning
200	OK — Request successful
400	Bad Request — Missing or invalid parameters
401	Unauthorized — Invalid or missing API key
429	Too Many Requests — Rate limit exceeded
500	Server Error — Try again later

Ready to integrate?

Start with 5 free trial calls on this API. No credit card required.

Get API Key — Free Browse All APIs

Driving License Text and PDF