Dubai Vehicle Details V2

Endpoint Overview

POST /api/v1/dubai-vehicle/details-v2

Description

This API retrieves comprehensive vehicle registration details from Dubai's vehicle registry database. It provides authenticated access to official vehicle information including registration status, owner details, technical specifications, and insurance information based on the provided plate information and other identifying parameters.

Key Benefits

Access official Dubai vehicle registration data for verification and validation

Retrieve comprehensive vehicle specifications and ownership details in a single API call

Streamline vehicle-related processes with accurate and up-to-date information

Reduce manual data entry and verification steps in vehicle-related workflows

Use Cases

Financial Services

Transportation & Logistics

Government & Compliance

Verify vehicle details during auto loan or lease application processing

Validate vehicle information for insurance policy issuance and claims

Confirm vehicle ownership during financing approval workflows

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
plate_code	String	Yes	The alphabetic code displayed on the vehicle's license plate
plate_number	String	Yes	The numeric portion of the vehicle's license plate
vehicle_category	String (Enum)	Yes	Category of the vehicle from the predefined list
traffic_file_number	String	Yes	Official traffic file number associated with the vehicle
registration_date	String	Yes	Date of vehicle registration in "YYYY-MM-DD" format

Vehicle Category Values

The vehicle_category parameter must be one of the following values:

dubai_police

learning_vehicle

import

motorcycle

private

taxi

public_transportation

trade_plate

export

consulate_authority

political_authority

international_organization

protocol

government_vehicle

private_transportation

data_migration

classical

entertainment_motorcycle

trailer

dubai_flag

under_test

Example Request

{
    "plate_code": "G",
    "plate_number": "12345",
    "vehicle_category": "private",
    "traffic_file_number": "12345678",
    "registration_date": "2017-05-10"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the vehicle details
data.client_id	String	Unique identifier for the API request
data.plate_number	String	Vehicle's plate number
data.plate_code	String	Alphabetic code on the vehicle's license plate
data.traffic_file_number	String	Official traffic file number
data.vehicle_category	String	Category of the vehicle
data.registration_date	String	Date of registration in "YYYY-MM-DD" format
data.place_of_issue	String	Location where the vehicle was registered
data.owner_name	String	Full name of the vehicle's registered owner
data.policy_number	String	Vehicle's insurance policy number
data.nationality	String	Nationality of the vehicle owner
data.insurance_company	String	Name of the insurance provider
data.country_of_manufacture	String	Country where the vehicle was manufactured
data.vehicle_color	String	Color of the vehicle
data.vehicle_class	String	Classification of the vehicle
data.vehicle_type	String	Make and model of the vehicle
data.empty_weight	Integer	Weight of the vehicle without load (in kg)
data.total_weight	Integer	Maximum allowed weight of the vehicle (in kg)
data.engine_no	String	Vehicle's engine identification number
data.chassis_number	String	Vehicle's chassis/VIN number
data.date_of_expiry	String	Registration expiry date in "YYYY-MM-DD" format
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": {
        "client_id": "dubai_vehicle_details_v2_uZtbfnaeNmmIethOwNCA",
        "plate_number": "12345",
        "plate_code": "G",
        "traffic_file_number": "1234568",
        "vehicle_category": "private",
        "registration_date": "2017-05-10",
        "place_of_issue": "Dubai",
        "owner_name": "JAWAD ABDELREDA ABDELBAQI AL",
        "policy_number": "DB-C-12345",
        "nationality": "Jordan",
        "insurance_company": "JORDAN INSURANCE CO. LTD.",
        "country_of_manufacture": "JORDAN INSURANCE CO. LTD.",
        "vehicle_color": "White",
        "vehicle_class": "STATION",
        "vehicle_type": "AUDI Q7",
        "empty_weight": "1950",
        "total_weight": "2550",
        "engine_no": "CRE 136707",
        "chassis_number": "WA1AGDF76HD0123456",
        "date_of_expiry": "2025-04-21"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

Validation Error

Vehicle Not Found

{
    "status_code": 401,
    "success": false,
    "message": "Authentication failed. Invalid or missing token.",
    "message_code": "authentication_failed"
}

This error occurs when the JWT token is missing, expired, or invalid.

Integration Best Practices

Security Recommendations

Store API credentials 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 in transit

Implement token refresh mechanisms to handle JWT expiration gracefully

User Experience Guidelines

Validate user input before making API calls to reduce errors

Implement appropriate loading states while waiting for API responses

Display vehicle details in a structured, easy-to-read format

Provide clear error messages to users when vehicle information cannot be retrieved

Code Samples

cURL

Python

Node.js

Related APIs

Dubai Vehicle Ownership Verification - Verifies vehicle ownership against provided identity information

Dubai Vehicle Registration Status - Checks current registration status of a Dubai vehicle

Dubai Vehicle Insurance Verification - Validates insurance coverage details for Dubai vehicles

Compliance and Legal Considerations

This API provides access to official vehicle registration data and must be used in compliance with UAE data protection regulations. The data should only be used for legitimate business purposes with proper user consent where required. Unauthorized use or storage of this data may violate local privacy laws and regulations.

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/dubai-vehicle/details-v2' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "plate_code": "G", "plate_number": "12345", "vehicle_category": "private", "traffic_file_number": "12345678", "registration_date": "2017-05-10" }'

{ "data": { "client_id": "dubai_vehicle_details_v2_uZtbfnaeNmmIethOwNCA", "plate_number": "12345", "plate_code": "G", "traffic_file_number": "1234568", "vehicle_category": "private", "registration_date": "2017-05-10", "place_of_issue": "Dubai", "owner_name": "JAWAD ABDELREDA ABDELBAQI AL", "policy_number": "DB-C-12345", "nationality": "Jordan", "insurance_company": "JORDAN INSURANCE CO. LTD.", "country_of_manufacture": "JORDAN INSURANCE CO. LTD.", "vehicle_color": "White", "vehicle_class": "STATION", "vehicle_type": "AUDI Q7", "empty_weight": "1950", "total_weight": "2550", "engine_no": "CRE 136707", "chassis_number": "WA1AGDF76HD0123456", "date_of_expiry": "2025-04-21" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Dubai Vehicle Details V2

Dubai Vehicle Details V2#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Vehicle Category Values#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Dubai Vehicle Details V2

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Vehicle Category Values

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples