UAE Driving License Verification

Endpoint Overview

POST /api/v1/uae/license-verification

Description

This API endpoint allows you to verify UAE driving license details by providing the license ID number, issue date, traffic file number, and birth year. The service returns comprehensive information about the license holder including personal details, license status, vehicle class information, black points, and eye test results.

Key Benefits

Instant verification of UAE driving license authenticity

Access to comprehensive license details including status and expiry

Retrieve vehicle class information and restrictions

Verify eye test results and medical fitness for driving

Use Cases

Insurance

Car Rental

Transportation

Verify driver's license details before issuing auto insurance policies

Validate license status and black points for risk assessment

Confirm vehicle classes for appropriate coverage

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
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	Driving license ID number
issue_date	String	Yes	License issue date in "YYYY-MM-DD" format
traffic_file_number	String	Yes	Traffic file number
birth_year	String	Yes	Birth year of the license holder

Example Request

{
    "id_number": "164303",
    "issue_date": "2021-09-01",
    "traffic_file_number": "142996",
    "birth_year": "1994"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all license verification details
data.client_id	String	Unique client identifier
data.id_number	String	Driving license ID number
data.issue_date	String	License issue date in "YYYY-MM-DD" format
data.traffic_file_number	String	Traffic file number
data.birth_year	String	Birth year of the license holder
data.full_name	String	Full name as per driving license
data.black_points	String	Number of black points on the license
data.license_type	String	Type of license (e.g., Permanent)
data.license_status	String	Current status of the license
data.dob	String	Date of birth in "YYYY-MM-DD" format
data.expiry_date	String	License expiry date in "YYYY-MM-DD" format
data.vehicle_class	Array	List of vehicle classes the holder is authorized to drive
data.vehicle_class[].vehicle_type	String	Type of vehicle authorized
data.vehicle_class[].valid_till	String	Validity date for the vehicle class in "YYYY-MM-DD" format
data.eye_test_results	Object	Details of the license holder's eye test
data.eye_test_results.test_center	String	Name of the eye test center
data.eye_test_results.right_eye_result	String	Vision test result for right eye
data.eye_test_results.left_eye_result	String	Vision test result for left eye
data.eye_test_results.color_blindness	String	Color blindness status
data.eye_test_results.test_date	String	Date of eye test in "YYYY-MM-DD" format
data.eye_test_results.test_expiry_date	String	Expiry date of eye test in "YYYY-MM-DD" format
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Code indicating the response status

Example Successful Response

{
    "data": {
        "client_id": "uae_driving_license_EhtzagePGanepcglBssd",
        "id_number": "0001303",
        "issue_date": "2021-09-01",
        "traffic_file_number": "000996",
        "birth_year": "1994",
        "full_name": "HOMAYUN KABIR",
        "black_points": "0",
        "license_type": "Permanent",
        "license_status": "With Owner",
        "dob": "1994-00-00",
        "expiry_date": "2028-00-00",
        "vehicle_class": [
            {
                "vehicle_type": "Light Vehicle Automatic",
                "valid_till": "2021-00-00"
            }
        ],
        "eye_test_results": {
            "test_center": "Max Vision Trading",
            "right_eye_result": "6/6",
            "left_eye_result": "6/6",
            "color_blindness": "Fit",
            "test_date": "2020-10-14",
            "test_expiry_date": "2023-00-00"
        }
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Credentials

Authentication Error

Missing Parameters

{
    "status_code": 400,
    "success": false,
    "message": "Invalid license credentials",
    "message_code": "invalid_credentials"
}

Returned when the provided license details do not match any record.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption

Implement token refresh mechanisms to handle token expiration

User Experience Guidelines

Implement proper validation for date formats before submitting requests

Display clear error messages to users when verification fails

Cache verification results (where appropriate) to improve response times

Provide clear feedback during the verification process

Code Samples

cURL

Python

Node.js

Related APIs

UAE ID Card Verification - Verify UAE national ID card details

UAE Visa Verification - Verify UAE visa status and details

UAE Vehicle Registration - Verify vehicle registration details in UAE

Compliance and Legal Considerations

This API handles personal identification information (PII) and is subject to UAE data protection regulations. Ensure you have proper consent from users before verifying their license information. The data should be stored securely and used only for the intended verification purposes. Compliance with UAE Federal Law No. 2 of 2019 on the use of Information and Communication Technology in healthcare is recommended.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/uae/license-verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "164303", "issue_date": "2021-09-01", "traffic_file_number": "142996", "birth_year": "1994" }'

{ "data": { "client_id": "uae_driving_license_EhtzagePGanepcglBssd", "id_number": "0001303", "issue_date": "2021-09-01", "traffic_file_number": "000996", "birth_year": "1994", "full_name": "HOMAYUN KABIR", "black_points": "0", "license_type": "Permanent", "license_status": "With Owner", "dob": "1994-00-00", "expiry_date": "2028-00-00", "vehicle_class": [ { "vehicle_type": "Light Vehicle Automatic", "valid_till": "2021-00-00" } ], "eye_test_results": { "test_center": "Max Vision Trading", "right_eye_result": "6/6", "left_eye_result": "6/6", "color_blindness": "Fit", "test_date": "2020-10-14", "test_expiry_date": "2023-00-00" } }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

UAE Driving license

UAE Driving License Verification#

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

UAE Driving License Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples