UAE Commercial License OCR

Endpoint Overview

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

Description

This API endpoint extracts key information from UAE commercial licenses using Optical Character Recognition (OCR) technology. It processes images or PDF files of various UAE commercial license types and returns structured data including the license number and document type. The service supports multiple emirates and license categories, providing a reliable solution for identity verification and KYC processes.

Key Benefits

Automated extraction of license information from 30+ UAE commercial license types

High-confidence OCR with accuracy scores for each extracted field

Reduces manual data entry errors and processing time

Streamlines customer onboarding and verification workflows

Use Cases

Financial Services

Business Services

Government & Compliance

Business account opening verification for banks and financial institutions

Merchant onboarding for payment service providers

Business loan application processing and verification

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 `multipart/form-data`

Request Body

Parameter	Type	Required	Description
file	File	Yes	Image or PDF file of the UAE commercial license. Supported formats include JPG, PNG, and PDF.
use_pdf	Boolean	No	When file type is pdf

Example Request

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the extracted data and client identifier
data.client_id	String	Unique identifier for the OCR request
data.ocr_fields	Array	Array of objects containing the extracted OCR data
data.ocr_fields[].document_type	String	Type of UAE commercial license detected (see enum values below)
data.ocr_fields[].license_number	Object	Contains the extracted license number and confidence score
data.ocr_fields[].license_number.value	String	The extracted license number
data.ocr_fields[].license_number.confidence	Integer	Confidence score for the extracted license number (0-100)
data.ocr_fields[].standard_document	Boolean	Indicates if the document follows standard format
status_code	Integer	HTTP status code of the response
message_code	String	Status message code
message	String	Additional message information (null if successful)
success	Boolean	Indicates if the API call was successful

Example Successful Response

{
    "data": {
        "client_id": "uae_com_license_fzJseMkjrlnUlgvHczwG",
        "ocr_fields": [
            {
                "document_type": "fujairah_professional_license",
                "license_number": {
                    "value": "12734",
                    "confidence": 98
                },
                "standard_document": true
            }
        ]
    },
    "status_code": 200,
    "message_code": "success",
    "message": null,
    "success": true
}

Possible Error Responses

Authentication Error

Invalid File

OCR Processing Error

{
    "data": null,
    "status_code": 401,
    "message_code": "unauthorized",
    "message": "Invalid or expired authentication token",
    "success": false
}

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

Supported Document Types

The API can identify and extract data from the following UAE commercial license types:

Document Type Value	Description
dubai_com_license	Dubai Commercial License
abu_dhabi_tourism_license	Abu Dhabi Tourism License
sharjah_business_license	Sharjah Business License
sharjah_trading_license	Sharjah Trading License
fujairah_trade_license	Fujairah Trade License
dubai_business_license	Dubai Business License
fujairah_professional_license	Fujairah Professional License
ras_al_khaimah_tourism_license	Ras Al Khaimah Tourism License
ras_al_khaimah_services_license	Ras Al Khaimah Services License
ras_al_khaimah_com_license	Ras Al Khaimah Commercial License
ajman_trade_license	Ajman Trade License
ajman_commercial_license	Ajman Commercial License
ajman_com_license	Ajman Commercial License
dubai_service_license	Dubai Service License
sharjah_publishing_business_license	Sharjah Publishing Business License
ajman_tourism_license	Ajman Tourism License
sharjah_professional_license	Sharjah Professional License
abu_dhabi_business_tourism_license	Abu Dhabi Business Tourism License
abu_dhabi_com_license	Abu Dhabi Commercial License
umm_ai_quwain_com_license	Umm Al Quwain Commercial License
dubai_professional_license	Dubai Professional License
ajman_professional_license	Ajman Professional License
dubai_tourism_license	Dubai Tourism License
sharjah_publishing_professional_license	Sharjah Publishing Professional License
ajman_business_license	Ajman Business License
united_arab_professional_license	United Arab Emirates Professional License
ajman_service_license	Ajman Service License
quwain_com_license	Quwain Commercial License
dubai_renew_license	Dubai Renewal License
sharjah_license	Sharjah License
abu_dhabi_business_license	Abu Dhabi Business License
dhabi_com_license_license	Abu Dhabi Commercial License
fujairah_com_license	Fujairah Commercial License

Integration Best Practices

Security Recommendations

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

Implement proper error handling to manage API failures gracefully

Use HTTPS for all API communications to ensure data security

Implement token refresh mechanisms to handle token expiration

User Experience Guidelines

Provide clear instructions to users about acceptable document formats and quality

Implement a loading state while OCR processing is in progress

Allow users to review and correct extracted information if needed

Provide clear error messages when document processing fails

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

UAE Visa OCR: Extracts information from UAE visa documents

Document Verification: Verifies the authenticity of extracted document information

Compliance and Legal Considerations

When implementing this API, ensure compliance with UAE data protection regulations and privacy laws. The extracted data should be handled securely and used only for legitimate business purposes. Users should be informed about the data collection and processing through appropriate privacy notices and consent mechanisms.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

{ "data": { "client_id": "uae_com_license_fzJseMkjrlnUlgvHczwG", "ocr_fields": [ { "document_type": "fujairah_professional_license", "license_number": { "value": "12734", "confidence": 98 }, "standard_document": true } ] }, "status_code": 200, "message_code": "success", "message": null, "success": true }

Com License OCR

UAE Commercial License OCR#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Supported Document Types#

Integration Best Practices#

Code Samples#

Request

Responses