Dubai Vehicle Verification

Endpoint Overview

POST /api/v1/dubai-vehicle/verify

Description

The Dubai Vehicle Verification API allows you to validate and retrieve information about vehicles registered in Dubai. By providing the plate code and plate number, you can verify a vehicle's registration status and retrieve its expiry date. This API is essential for businesses that need to confirm vehicle registration details for regulatory compliance, insurance purposes, or vehicle-related services.

Key Benefits

Instant verification of Dubai vehicle registration status

Access to official vehicle expiry date information

Streamlined vehicle validation process for business operations

Reduced manual verification overhead and human error

Use Cases

Insurance

Transportation

Financial Services

Verify vehicle registration details before issuing or renewing insurance policies

Validate vehicle information during claims processing

Automate vehicle verification in insurance application 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
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
plate_code	String	Yes	The code displayed on the vehicle's license plate (e.g., "F")
plate_number	String	Yes	The numeric part of the vehicle's license plate (e.g., "03320")

Example Request

{
    "plate_code": "F",
    "plate_number": "03320"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the verification result data
data.client_id	String	Unique identifier for the verification request
data.plate_code	String	The plate code provided in the request
data.plate_number	String	The plate number provided in the request
data.expiry_date	String	The vehicle's registration expiry date in YYYY-MM-DD format
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the API call was successful
message	String	Human-readable description of the result
message_code	String	Machine-readable code representing the result

Example Successful Response

{
    "data": {
        "client_id": "dubai_vehicle_verify_IuaPusOFyknwlpxqnciz",
        "plate_code": "F",
        "plate_number": "03320",
        "expiry_date": "2007-08-19"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Plate Details

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid plate details provided",
    "message_code": "invalid_plate_details"
}

This error occurs when the provided plate code or plate number is invalid or does not exist in the system.

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

Use HTTPS for all API communications to ensure data encryption

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement input validation before making API calls to ensure correct plate formats

Display clear error messages to users when verification fails

Implement appropriate loading indicators during API calls

Cache successful verification results when appropriate to reduce API calls

Code Samples

cURL

Python

Node.js

Related APIs

UAE Driver License Verification API: Verify driver license details for UAE residents

Dubai Vehicle Registration API: Register vehicles in the Dubai system

UAE Vehicle Insurance Verification API: Verify insurance status for UAE vehicles

Compliance and Legal Considerations

This API provides access to official vehicle registration data. Usage must comply with UAE data protection regulations and the Dubai Roads and Transport Authority (RTA) guidelines. Ensure you have proper authorization to access vehicle information and that you handle the data in accordance with privacy laws.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/dubai-vehicle/verify' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "plate_code": "F", "plate_number": "03320" }'

{ "data": { "client_id": "dubai_vehicle_verify_IuaPusOFyknwlpxqnciz", "plate_code": "F", "plate_number": "03320", "expiry_date": "2007-08-19" }, "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 Verify

Dubai Vehicle 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

Dubai Vehicle 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