UAE ED License Verification

Endpoint Overview

POST /api/v1/uae-ed/license-verification

Description

This API endpoint allows you to verify UAE Economic Department (ED) licenses by providing a license number. The service returns comprehensive business information including license status, expiry date, business name, address, and activity details in both English and Arabic. This verification helps organizations confirm the legitimacy and current status of UAE-registered businesses.

Key Benefits

Instant verification of UAE ED license validity and status

Access to comprehensive business details including legal form and activities

Retrieval of both English and Arabic business information

Verification of license expiry dates to ensure compliance

Use Cases

Financial Services

Corporate Services

Government & Regulatory

KYC verification during business account opening

Due diligence for corporate lending and financing

Verification of business partners for compliance requirements

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
ed_licence_number	String	Yes	ED license number to be verified

Example Request

{
    "ed_licence_number": "673471"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verification results
data.client_id	String	Unique client identifier
data.ed_license_number	String	ED license number that was verified
data.cbls_number	String	CBLS number of the business
data.ba_desc	String	Business activity description
data.address	String	Full address of the business
data.phone_number	String	Phone number of the business
data.expiry_date	String	ED license expiry date in "YYYY-MM-DD" format
data.business_name	String	Name of business as per ED license
data.results	Array	Array containing detailed verification results
status_code	Number	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

Results Object Parameters

Parameter	Type	Description
ed_license_number	String	ED license number
license_status	String	Current status of the license
expiry_date	String	License expiry date in "YYYY-MM-DD" format
licensing_authority	String	Name of the authority that issued the license
cbls_number	String	CBLS number
activity_name	String	Business activity details in English
legal_form	String	Legal form of the business
activity_name_arabic	String	Business activity details in Arabic
address	String	Full address of the business
phone_number	String	Phone number of the business
business_name	String	Business name in English
business_name_arabic	String	Business name in Arabic

Example Successful Response

{
    "data": {
        "client_id": "uae_ed_license_YmDnWjbErNwDycdIKmQb",
        "ed_license_number": "100000",
        "cbls_number": "108804",
        "ba_desc": "",
        "address": "Bur Dubai Oud Metha",
        "phone_number": null,
        "expiry_date": "2024-07-07",
        "business_name": "XYZ TOURISM L.L.C",
        "results": [
            {
                "ed_license_number": "100000",
                "license_status": "فعال",
                "expiry_date": "2024-07-07",
                "licensing_authority": "دائرة تصاد والسياحة دبى",
                "cbls_number": "108804",
                "activity_name": "In Bound Tour Operator",
                "legal_form": "شركة الشخص الواحد ش.ش.و",
                "activity_name_arabic": "منظمياحه,منظم رحلات سياحية خارجية",
                "address": "Oud Metha",
                "phone_number": null,
                "business_name": "XYZ TOURISM L.L.C",
                "business_name_arabic": "فور ياحة ش.ذ.م.م"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid License Number

License Not Found

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid license number provided",
    "message_code": "invalid_input"
}

The ED license number provided is invalid or in an incorrect format.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Rotate JWT tokens periodically and implement token expiration

User Experience Guidelines

Implement caching for frequently verified licenses to improve response times

Display verification results clearly with visual indicators for license status

Provide both English and Arabic information when displaying results to users

Include expiry date warnings when a license is approaching its expiration

Code Samples

cURL

Python

Node.js

Related APIs

UAE Business Registry Verification - Verify business details against the UAE business registry

UAE Trade License Verification - Verify trade licenses issued in the UAE

UAE Company Ownership Verification - Retrieve ownership information for UAE registered companies

UAE Business Activity Verification - Verify specific business activities against license permissions

Compliance and Legal Considerations

This API provides access to official UAE Economic Department license data. When implementing this API, ensure you comply with UAE data protection regulations and obtain necessary consent when storing or processing the retrieved business information. The data should only be used for legitimate business purposes such as KYC, due diligence, or regulatory compliance.

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-ed/license-verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "ed_licence_number": "673471" }'

{ "data": { "client_id": "uae_ed_license_YmDnWjbErNwDycdIKmQb", "ed_license_number": "100000", "cbls_number": "108804", "ba_desc": "", "address": "Bur Dubai Oud Metha", "phone_number": null, "expiry_date": "2024-07-07", "business_name": "XYZ TOURISM L.L.C", "results": [ { "ed_license_number": "100000", "license_status": "فعال", "expiry_date": "2024-07-07", "licensing_authority": "دائرة تصاد والسياحة دبى", "cbls_number": "108804", "activity_name": "In Bound Tour Operator", "legal_form": "شركة الشخص الواحد ش.ش.و", "activity_name_arabic": "منظمياحه,منظم رحلات سياحية خارجية", "address": "Oud Metha", "phone_number": null, "business_name": "XYZ TOURISM L.L.C", "business_name_arabic": "فور ياحة ش.ذ.م.م" } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

UAE ED License

UAE ED License Verification#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Results Object Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses