Driving License Verification API

Endpoint Overview

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

Description

This API endpoint allows you to verify and retrieve comprehensive details of an individual's driving license by providing their license number. The service validates the license against official government records and returns structured information including personal details, license validity dates, and address information.

Key Benefits

Instant verification of driving license authenticity against official records

Comprehensive data retrieval including personal details, validity dates, and address information

Reduced manual verification overhead and elimination of fraudulent license submissions

Seamless integration into KYC, vehicle rental, and insurance workflows

Use Cases

Vehicle Rental

Insurance

Transportation

Verify customer driving credentials before approving vehicle rentals

Automate driver verification for car and bike sharing platforms

Validate license expiration dates to ensure compliance with rental 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 authentication using JWT format
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	The driving license number to verify
additional_details	Object	No	Optional object containing supplementary information
additional_details.full_name	String	No	Full name of the license holder for additional verification
additional_details.dob	String	No	Date of birth in YYYY-MM-DD format for additional verification

Example Request

{
    "id_number": "UP20 20150000000",
    "additional_details": {
        "full_name": "Amit Mittal",
        "dob": "1996-11-23"
    }
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the driving license details
data.temporary_address	String	Temporary address registered with the license
data.father_or_husband_name	String	Name of father or husband as registered
data.doe	String	Date of expiry of the license in YYYY-MM-DD format
data.temporary_zip	String	ZIP/Postal code of temporary address
data.permanent_address	String	Permanent address registered with the license
data.doi	String	Date of issue of the license in YYYY-MM-DD format
data.client_id	String	Unique client identifier
data.citizenship	String	Citizenship code (e.g., "IND" for India)
data.dob	String	Date of birth in YYYY-MM-DD format
data.permanent_zip	String	ZIP/Postal code of permanent address
data.gender	String	Gender of the license holder
data.license_number	String	Driving license number
data.name	String	Full name of the license holder
data.state	String	State code where the license was issued
data.ola_name	String	Name of the issuing authority
data.ola_code	String	Code of the issuing authority
status_code	Integer	HTTP status code of the response
message	String	Additional message (if any)
success	Boolean	Indicates if the request was successful

Example Successful Response

{
    "data": {
        "temporary_address": "TRIPATHI HAVELI, MIRZAPUR",
        "father_or_husband_name": "KALEEN BHAIYA",
        "doe": "2032-07-23",
        "temporary_zip": "231001",
        "permanent_address": "TRIPATHI HAVELI, MIRZAPUR",
        "doi": "2012-07-24",
        "client_id": "dIysSjHnIG",
        "citizenship": "IND",
        "dob": "1990-08-31",
        "permanent_zip": "231001",
        "gender": "Male",
        "license_number": "UP20 20150000000",
        "name": "MUNNA BHAIYA",
        "state": "UP",
        "ola_name": "DISTRICT TRANSPORT OFFICE, MIRZAPUR",
        "ola_code": "UP20"
    },
    "status_code": 200,
    "message": "",
    "success": true
}

Possible Error Responses

Invalid License Number

Authentication Error

Service Unavailable

{
    "data": null,
    "status_code": 400,
    "message": "Invalid license number format",
    "success": false
}

The provided license number is in an invalid format or does not exist in the records.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to prevent sensitive information leakage

Use HTTPS for all API communications to ensure data encryption in transit

Implement rate limiting on your end to prevent abuse of the API

User Experience Guidelines

Provide clear feedback to users when verification is in progress

Display appropriate error messages when verification fails

Implement a retry mechanism with exponential backoff for temporary failures

Cache verification results (where appropriate) to improve response times

Code Samples

cURL

Python

Node.js

Related APIs

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

Voter ID Verification API: Verify voter ID details for identity confirmation

Aadhaar Verification API: Verify Aadhaar card details for comprehensive identity verification

Vehicle Registration Verification API: Verify vehicle registration details against RTO records

Compliance and Legal Considerations

This API processes personal identification information and is subject to data protection regulations. Ensure you have proper consent from users before verifying their driving license details. The data should be handled in compliance with applicable privacy laws including but not limited to GDPR and local data protection regulations. Store verification results only as long as necessary for your business purposes.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/driving-license/driving-license' \ --header 'X-Customer-Id: {{customer_id}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "{{license_number}}", "additional_details": { "full_name": "Amit Mittal", "dob": "1996-11-23" } }'

{ "data": { "temporary_address": "TRIPATHI HAVELI, MIRZAPUR", "father_or_husband_name": "KALEEN BHAIYA", "doe": "2032-07-23", "temporary_zip": "231001", "permanent_address": "TRIPATHI HAVELI, MIRZAPUR", "doi": "2012-07-24", "client_id": "dIysSjHnIG", "citizenship": "IND", "dob": "1990-08-31", "permanent_zip": "231001", "gender": "Male", "license_number": "UP20 20150000000", "name": "MUNNA BHAIYA", "state": "UP", "ola_name": "DISTRICT TRANSPORT OFFICE, MIRZAPUR", "ola_code": "UP20" }, "status_code": 200, "message": "", "success": true }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

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