UAE Vehicle License OCR

Endpoint Overview

POST /api/v1/ocr/uae-vehicle-license

Description

This API endpoint extracts and processes information from UAE vehicle license documents. It performs Optical Character Recognition (OCR) on both the front and back sides of a UAE vehicle license, extracting key details such as vehicle information, owner details, registration dates, and technical specifications. The service returns structured data that can be easily integrated into applications for vehicle verification, insurance processing, or regulatory compliance.

Key Benefits

Automated extraction of vehicle license data eliminates manual data entry errors

Comprehensive data extraction from both front and back sides of the license

Structured response format for easy integration with existing systems

Reduces processing time for vehicle-related applications and verifications

Use Cases

Insurance

Vehicle Financing

Fleet Management

Automate policy creation by extracting vehicle and owner details

Verify insurance expiry dates during policy renewal

Validate vehicle details during claims processing

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	Must be set to `multipart/form-data`

Request Body

1. For File Upload

Parameter	Type	Required	Description
front	File (Image)	Yes	Upload front image of license
back	File (Image)	Yes	Upload back image of license

2. For Base64 Input

Parameter	Type	Required	Description
front_base64	String	Yes	Front image of license in Base64 format
back_base64	String	Yes	Back image of license in Base64 format

3. For Image URL Input

Parameter	Type	Required	Description
front_link	String	Yes	URL for front image of license
back_link	String	Yes	URL for back image of license

Supported Image Formats

JPEG/JPG

PNG

PDF (first page will be processed)

Image Requirements

Clear, well-lit images without glare or shadows

All corners of the document should be visible

Minimum resolution: 300 DPI recommended

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the extracted information
data.client_id	String	Unique identifier for the OCR request
data.ocr_front_response	Object	Extracted data from the front side of the license
data.ocr_back_response	Object	Extracted data from the back side of the license
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

Front Side Response Fields (ocr_front_response)

Field	Type	Description
traffic_plate_number	String	The traffic plate number of the vehicle
place_of_issue	String	The place where the vehicle license was issued
tc_number	String	The Technical Committee number of the vehicle
nationality	String	The nationality of the vehicle owner
owner	String	The name of the vehicle owner
expiry_date	String	The expiry date of the vehicle license (YYYY-MM-DD)
ins_expiry	String	The expiry date of the vehicle insurance policy (YYYY-MM-DD)
policy_number	String	The policy number of the vehicle insurance
mortgage_by	String	The entity or party by which the vehicle is mortgaged
reg_date	String	The registration date of the vehicle (YYYY-MM-DD)

Back Side Response Fields (ocr_back_response)

Field	Type	Description
model	String	The year of the vehicle model
origin	String	The country of origin of the vehicle
vehicle_type	String	The type or model of the vehicle
gvw	String	Gross Vehicle Weight of the vehicle
engine_number	String	The engine number of the vehicle
chassis_number	String	The chassis number or VIN of the vehicle
number_of_pass	String	The maximum number of passengers allowed
empty_weight	String	The weight of the vehicle when empty

Example Successful Response

{
    "data": {
        "client_id": "ocr_uae_vehicle_license_EQMptCCymwptPtyTwrFT",
        "ocr_front_response": {
            "traffic_plate_number": "7220007374",
            "place_of_issue": "خطاب",
            "tc_number": "M/76123",
            "nationality": "SRI LANKA",
            "owner": "CHAMARA MADUSANK",
            "expiry_date": "2024-11-05",
            "ins_expiry": "2024-12-05",
            "policy_number": "30/101312345",
            "mortgage_by": "142",
            "reg_date": "2023-11-07"
        },
        "ocr_back_response": {
            "model": "2018",
            "origin": "Japan",
            "vehicle_type": "NISSAN X-TRAIL",
            "gvw": "2202",
            "engine_number": "QR252123456M",
            "chassis_number": "JN1BT2MW7JW12345678",
            "number_of_pass": "5",
            "empty_weight": "1785"
        }
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

Invalid Image

Missing Parameter

Server Error

{
    "error": null,
    "message": "Your token is invalid. Please ensure that correct token is being used.",
    "status_code": 401,
    "success": false,
    "message_code": "invalid_token"
}

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

Use HTTPS for all API communications to ensure data encryption in transit

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Provide clear instructions for capturing high-quality images of vehicle licenses

Implement a preview feature to allow users to verify image quality before submission

Display a loading indicator during OCR processing to indicate progress

Implement proper validation of extracted data and allow manual correction if needed

Code Samples

cURL

Python

Node.js

Related APIs

UAE ID Card OCR - Extracts information from UAE national ID cards

UAE Driving License OCR - Extracts information from UAE driving licenses

Document Verification - Verifies the authenticity of submitted documents

Compliance and Legal Considerations

When processing vehicle license information, ensure compliance with UAE data protection regulations. The extracted data should be used only for the specific purpose for which consent was obtained. Implement appropriate data retention policies and ensure secure storage of any personal information extracted from the documents.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

{ "data": { "client_id": "ocr_uae_vehicle_license_EQMptCCymwptPtyTwrFT", "ocr_front_response": { "traffic_plate_number": "7220007374", "place_of_issue": "خطاب", "tc_number": "M/76123", "nationality": "SRI LANKA", "owner": "CHAMARA MADUSANK", "expiry_date": "2024-11-05", "ins_expiry": "2024-12-05", "policy_number": "30/101312345", "mortgage_by": "142", "reg_date": "2023-11-07" }, "ocr_back_response": { "model": "2018", "origin": "Japan", "vehicle_type": "NISSAN X-TRAIL", "gvw": "2202", "engine_number": "QR252123456M", "chassis_number": "JN1BT2MW7JW12345678", "number_of_pass": "5", "empty_weight": "1785" } }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

UAE Vehicle License

UAE Vehicle License OCR#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

1. For File Upload#

2. For Base64 Input#

3. For Image URL Input#

Supported Image Formats#

Image Requirements#

Response Parameters#

Front Side Response Fields (ocr_front_response)#

Back Side Response Fields (ocr_back_response)#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses