Vehicle Details

Endpoint Overview

POST /api/v1/uae/vehicle-details

Description

This API endpoint retrieves comprehensive vehicle information from UAE government records based on the provided plate details. It returns detailed vehicle specifications, registration information, and insurance status, allowing applications to verify and utilize official vehicle data for various business processes.

Key Benefits

Instant access to official UAE vehicle registration data

Comprehensive vehicle specifications including make, model, and technical details

Insurance verification with expiry date information

Unique client ID for tracking and reference purposes

Use Cases

Insurance

Automotive

Financial Services

Pre-fill vehicle details during insurance quote generation

Verify vehicle specifications for accurate premium calculations

Validate existing insurance coverage and expiry dates

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
plate_number	String	Yes	The vehicle's plate number (numeric portion)
plate_city	String	Yes	The emirate where the vehicle is registered
plate_code	String	Yes	The plate code (alphanumeric identifier)

Supported Values for plate_city

abu_dhabi

dubai

sharjah

ajman

umm_al_quwain

ras_al_khaimah

fujairah

Example Request

{
    "plate_number": "53320",
    "plate_city": "dubai",
    "plate_code": "15"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the vehicle details
data.client_id	String	Unique identifier for the client/request
data.plate_number	String	The vehicle's plate number
data.maker	String	Vehicle manufacturer name
data.model	String	Vehicle model name
data.registration_date	String	Date when vehicle was registered (YYYY-MM-DD)
data.registration_year	String	Year when vehicle was registered
data.insurance_expiry_date	String	Date when insurance expires (YYYY-MM-DD)
data.chassis_number	String	Vehicle chassis/VIN number
data.fuel_type	String	Type of fuel used by the vehicle
data.no_of_cylinders	String	Number of engine cylinders
data.vehicle_type	String	Category of vehicle
data.seating_capacity	String	Number of seats in the vehicle
data.vehicle_horse_power	String	Engine power rating
status_code	Integer	HTTP status code
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": "uae_vehicle_sqwVlpjSBaUlntTLrlSU",
        "plate_number": "12345",
        "maker": "TOYOTA",
        "model": "SEQUOIA",
        "registration_date": "2014-04-06",
        "registration_year": "2014",
        "insurance_expiry_date": "2024-12-05",
        "chassis_number": "ABCDEFES0123456",
        "fuel_type": "PETROL",
        "no_of_cylinders": "8",
        "vehicle_type": "CAR",
        "seating_capacity": "8",
        "vehicle_horse_power": "381 HP"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

Invalid Parameters

Vehicle Not Found

{
    "status_code": 401,
    "success": false,
    "message": "Unauthorized access",
    "message_code": "unauthorized"
}

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

Integration Best Practices

Security Recommendations

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

Implement token refresh mechanisms to handle token expiration

Validate and sanitize all user inputs before sending to the API

Use HTTPS for all API communications

User Experience Guidelines

Implement proper error handling to provide meaningful feedback to users

Cache vehicle details when appropriate to improve application performance

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

Clearly indicate when vehicle data was last retrieved/verified

Code Samples

cURL

Python

Node.js

Related APIs

UAE Driver License Verification API: Verify driver license details in UAE

UAE Vehicle Insurance API: Detailed insurance information for UAE vehicles

UAE Traffic Violations API: Check for outstanding traffic violations by plate number

Compliance and Legal Considerations

This API accesses official UAE vehicle registration data. Usage must comply with UAE data protection laws and regulations. Ensure you have proper authorization to access vehicle information and that you handle the data in accordance with privacy regulations. Data should not be stored longer than necessary for the intended business purpose.

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/vehicle-details' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "plate_number": "53320", "plate_city": "dubai", "plate_code": "15" }'

{ "data": { "client_id": "uae_vehicle_sqwVlpjSBaUlntTLrlSU", "plate_number": "12345", "maker": "TOYOTA", "model": "SEQUOIA", "registration_date": "2014-04-06", "registration_year": "2014", "insurance_expiry_date": "2024-12-05", "chassis_number": "ABCDEFES0123456", "fuel_type": "PETROL", "no_of_cylinders": "8", "vehicle_type": "CAR", "seating_capacity": "8", "vehicle_horse_power": "381 HP" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Vehicle Details

Vehicle Details#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Supported Values for plate_city#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Vehicle Details

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Supported Values for plate_city

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples