Dubai Vehicle Detailed Information

Endpoint Overview

POST /api/v1/dubai-vehicle/detailed

Description

This API retrieves comprehensive details about vehicles registered in Dubai by providing the plate code and plate number. It returns a wealth of information including chassis number, traffic file details, insurance information, mortgage status, and vehicle specifications. This endpoint is particularly useful for verifying vehicle information for regulatory compliance, insurance validation, and vehicle ownership verification.

Key Benefits

Instant access to official Dubai vehicle registration data

Comprehensive vehicle details in a single API call

Verification of insurance validity and expiration dates

Confirmation of mortgage status and associated financial institutions

Use Cases

Insurance

Financial Services

Vehicle Marketplaces

Verify insurance policy details before issuing new coverage

Validate existing insurance information during claims processing

Confirm insurance expiry dates for renewal notifications

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
plate_code	String	Yes	The vehicle plate code (e.g., "M")
plate_number	String	Yes	The vehicle plate number (e.g., "00234")

Example Request

{
    "plate_code": "M",
    "plate_number": "00234"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the vehicle information
data.client_id	String	Unique identifier for the client/request
data.chassis_number	String	Vehicle chassis number
data.plate_number	String	Vehicle plate number
data.plate_code	String	Vehicle plate code
data.traffic_file_number	String	Traffic file number associated with the vehicle
data.fit_upto	String	Vehicle fitness certification expiry date (YYYY-MM-DD)
data.mortgage_status	String	Current mortgage status ("Yes" or "No")
data.mortgage_company	String	Name of the mortgage company (if applicable)
data.color	String	Vehicle color
data.model	String	Vehicle model name
data.model_year	String	Year of vehicle manufacture
data.vehicle_class_description	String	Description of the vehicle class
data.insurance_company	String	Name of the insurance provider
data.insurance_number	String	Insurance policy number
data.insurance_valid_upto	String	Insurance policy expiry date (YYYY-MM-DD)
data.insurance_issue_date	String	Insurance policy issue date (YYYY-MM-DD)
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": "dubai_vehicle_detailed_RJwrntUQyXylzNuThnlH",
        "chassis_number": "JTGJX02PXC50123456",
        "plate_number": "91000",
        "plate_code": "M",
        "traffic_file_number": "501700000",
        "fit_upto": "2024-01-10",
        "mortgage_status": "No",
        "mortgage_company": "",
        "color": "White Trade name",
        "model": "TOYOTA HIACE",
        "model_year": "2012",
        "vehicle_class_description": "Light Bus",
        "insurance_company": "WATANIA TAKAFUL GENERAL P.J.S.C.",
        "insurance_number": "AU0523123123",
        "insurance_valid_upto": "2024-02-10",
        "insurance_issue_date": "2023-01-11"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Credentials

Invalid Parameters

Vehicle Not Found

{
    "status_code": 401,
    "success": false,
    "message": "Invalid credentials",
    "message_code": "unauthorized"
}

Authentication failed due to invalid or expired JWT token.

Integration Best Practices

Security Recommendations

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

Implement token rotation and expiration handling

Use HTTPS for all API communications

Implement proper error handling for authentication failures

User Experience Guidelines

Provide clear feedback when vehicle information cannot be found

Display insurance and fitness expiration dates in a user-friendly format

Highlight critical information like expired certifications or mortgage status

Implement caching strategies to improve response times for frequently queried vehicles

Code Samples

cURL

Python

Node.js

Related APIs

Dubai Vehicle Basic Information API - Provides basic vehicle information with fewer details

Dubai Driver License Verification API - Verifies driver license details

Dubai Traffic Violations API - Retrieves traffic violations associated with a vehicle

Compliance and Legal Considerations

This API provides access to official vehicle registration data from Dubai authorities. Usage of this data must comply with UAE data protection regulations. The data should only be used for legitimate business purposes such as verification, compliance, or authorized services. Storing this data beyond the immediate use case may require additional compliance measures.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/dubai-vehicle/detailed' \ --header 'Content-Type: application/json' \ --data-raw '{ "plate_code": "M", "plate_number": "00234" }'

{ "data": { "client_id": "dubai_vehicle_detailed_RJwrntUQyXylzNuThnlH", "chassis_number": "JTGJX02PXC50123456", "plate_number": "91000", "plate_code": "M", "traffic_file_number": "501700000", "fit_upto": "2024-01-10", "mortgage_status": "No", "mortgage_company": "", "color": "White Trade name", "model": "TOYOTA HIACE", "model_year": "2012", "vehicle_class_description": "Light Bus", "insurance_company": "WATANIA TAKAFUL GENERAL P.J.S.C.", "insurance_number": "AU0523123123", "insurance_valid_upto": "2024-02-10", "insurance_issue_date": "2023-01-11" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Vehicle Details

Dubai Vehicle Detailed Information#

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

Dubai Vehicle Detailed Information

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples