Driving License Verification API

Endpoint Overview

POST /api/v1/driving-license/driving-license

Description

The Driving License Verification API allows you to validate and retrieve comprehensive information from a driving license by providing the license number and date of birth. This API performs real-time verification against official government records to confirm the authenticity of the driving license and returns detailed information about the license holder, including personal details, license validity, and permitted vehicle classes.

Key Benefits

Instant verification of driving license authenticity against official records

Comprehensive data retrieval including personal details, address, and license validity

Access to license holder's photograph for additional verification

Vehicle class permissions and license status information for complete verification

Use Cases

Financial Services

Transportation

Government & Compliance

KYC verification during customer onboarding for loans and credit cards

Identity verification for opening bank accounts

Risk assessment for auto insurance policies

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT format)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	The driving license number to be verified
dob	String	Yes	Date of birth of the license holder in "YYYY-MM-DD" format

Example Request

{
    "id_number": "TS02620190003657",
    "dob": "1998-06-15"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all the driving license details
data.client_id	String	Unique client identifier generated for this verification
data.license_number	String	The verified driving license number
data.state	String	State where the license was issued
data.name	String	Full name of the license holder
data.permanent_address	String	Permanent address of the license holder
data.permanent_zip	String	Permanent address ZIP code
data.temporary_address	String	Temporary address (if different from permanent)
data.temporary_zip	String	Temporary address ZIP code
data.citizenship	String	Citizenship information of the license holder
data.ola_name	String	Office of Licensing Authority name
data.ola_code	String	Office of Licensing Authority code
data.gender	String	Gender of the license holder (M, F, or X)
data.father_or_husband_name	String	Name of the license holder's father or husband
data.dob	String	Date of birth in "YYYY-MM-DD" format
data.doe	String	Date of expiry of the license in "YYYY-MM-DD" format
data.transport_doe	String	Date of expiry of transport license in "YYYY-MM-DD" format
data.doi	String	Date of issuance of the license in "YYYY-MM-DD" format
data.transport_doi	String	Date of issuance of transport license in "YYYY-MM-DD" format
data.profile_image	String	Base64 encoded profile image of the license holder
data.has_image	Boolean	Indicates if a profile image is available
data.blood_group	String	Blood group of the license holder
data.vehicle_classes	Array	List of vehicle classes the holder is permitted to drive
data.less_info	Boolean	Indicates if limited information is available
data.initial_doi	String	Initial date of issuance in "YYYY-MM-DD" format
data.current_status	String	Current status of the license (Active, Inactive, etc.)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the type of message

Example Successful Response

{
    "data": {
        "client_id": "license_iDdklSZIkxXfDrhVupRZ",
        "license_number": "TS02620190003657",
        "state": "Uttar Pradesh",
        "name": "MUNNA BHAIYA",
        "permanent_address": "TRIPATHI HAVELI, MIRZAPUR, UTTAR PRADESH",
        "permanent_zip": "",
        "temporary_address": "TRIPATHI HAVELI, MIRZAPUR, UTTAR PRADESH",
        "temporary_zip": "",
        "citizenship": "",
        "ola_name": "RTA MAHABUBABAD",
        "ola_code": "TS026",
        "gender": "M",
        "father_or_husband_name": "KALEEN BHAIYA",
        "dob": "1998-06-15",
        "doe": "2039-07-23",
        "transport_doe": "1800-01-01",
        "doi": "2019-07-24",
        "transport_doi": "1800-01-01",
        "profile_image": "base64Image",
        "has_image": true,
        "blood_group": "",
        "vehicle_classes": [
            "MCWG",
            "LMV-NT"
        ],
        "less_info": false
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid Driving Licence Number

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

The provided PAN number does not match the required format or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API keys securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Implement rate limiting to prevent abuse

Validate and sanitize all user inputs before sending to the API

User Experience Guidelines

Implement proper loading states while waiting for API responses

Display clear error messages to users when verification fails

Allow users to correct information if verification fails

Cache successful verification results to minimize repeated API calls

Implement progressive disclosure of information based on verification status

Code Samples

cURL

Python

Node.js

Related APIs

PAN Card Verification API: Verify PAN card details against government records

Aadhaar Verification API: Verify Aadhaar card details with OTP authentication

Voter ID Verification API: Verify voter ID details against electoral records

Address Verification API: Verify residential address details

Compliance and Legal Considerations

This API accesses government driving license records and must be used in compliance with data protection regulations. Ensure you have proper consent from users before verifying their driving license information. The data retrieved should be handled securely and in accordance with privacy laws. Usage of this API may be subject to audit by regulatory authorities.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/driving-license/driving-license' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "{{license_number}}", "dob": "{{dob}}" }'

{ "data": { "client_id": "license_iDdklSZIkxXfDrhVupRZ", "license_number": "TS02620190003657", "state": "Uttar Pradesh", "name": "MUNNA BHAIYA", "permanent_address": "TRIPATHI HAVELI, MIRZAPUR, UTTAR PRADESH", "permanent_zip": "", "temporary_address": "TRIPATHI HAVELI, MIRZAPUR, UTTAR PRADESH", "temporary_zip": "", "citizenship": "", "ola_name": "RTA MAHABUBABAD", "ola_code": "TS026", "gender": "M", "father_or_husband_name": "KALEEN BHAIYA", "dob": "1998-06-15", "doe": "2039-07-23", "transport_doe": "1800-01-01", "doi": "2019-07-24", "transport_doi": "1800-01-01", "profile_image": "base64Image", "has_image": true, "blood_group": "", "vehicle_classes": [ "MCWG", "LMV-NT" ], "less_info": false }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Driving License

Driving License Verification API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses