DED License Verification

Endpoint Overview

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

Description

This API endpoint allows you to verify Dubai Economic Department (DED) licenses by providing a license number and type. It returns comprehensive details about the license including its status, validity dates, registered activities, commercial tenancy information, and member details. This verification helps businesses and regulatory bodies confirm the legitimacy and current status of commercial licenses in the UAE.

Key Benefits

Instant verification of DED license validity and status

Access to detailed license information including expiry dates and registration numbers

Retrieve complete member details including roles, nationalities, and ownership shares

Obtain commercial tenancy contract information for the registered business

Use Cases

Financial Services

Real Estate

Business Services

KYC verification for business banking customers

Risk assessment for commercial loan applications

Verification of business legitimacy before establishing financial relationships

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
ded_licence_number	String	Yes	The license number issued by Dubai Economic Department
ded_licence_type	String	Yes	The type of license (e.g., commercial)

Example Request

{
    "ded_licence_number": "35343",
    "ded_licence_type": "commercial"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all license verification details
data.client_id	String	Unique client identifier
data.ded_license_number	String	License number
data.ded_license_type	String	License type
data.trade_name	String	Trade name as per license details
data.license_status	String	Current status of the license (e.g., Approved)
data.issue_date	String	Date when the license was issued (YYYY-MM-DD)
data.expiry_date	String	Date when the license expires (YYYY-MM-DD)
data.registration_number	String	License registration number
data.activities	Array	List of business activities permitted under the license
data.commercial_tenancy_contract	Object	Details of the commercial tenancy
data.member_details	Array	List of members associated with the license
status_code	Integer	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

Commercial Tenancy Contract Object

Parameter	Type	Description
property_name	String	Name of the property as per license details
landlord_name	String	Name of the property owner
tenant_name	String	Name of the property tenant as per license details
rent_amount_yearly	String	Annual rent amount
start_date	String	Tenancy start date (YYYY-MM-DD)
expiry_date	String	Tenancy expiry date (YYYY-MM-DD)
total_of_checks	String	Total number of checks for rent payment

Member Details Object

Parameter	Type	Description
member_name	String	Name of the member
nationality	String	Nationality of the member
role	String	Role of the member in the business
share	String	Percentage share owned by the member

Example Successful Response

{
    "data": {
        "client_id": "uae_ded_license_qzpiJhaYfuKdCkkZqotQ",
        "ded_license_number": "12345",
        "ded_license_type": "commercial",
        "trade_name": "M R  L.L.C",
        "license_status": "Approved",
        "issue_date": "2022-10-13",
        "expiry_date": "2023-10-12",
        "registration_number": "RN - 18520",
        "activities": [
            "Typing and Documents Photocopying Services",
            "Travel Tickets Selling"
        ],
        "commercial_tenancy_contract": {
            "property_name": "ععبدالله صالح المدنى",
            "landlord_name": "عدن عبدالله صالح المدنى",
            "tenant_name": "Abdulla",
            "rent_amount_yearly": "30000",
            "start_date": "2022-05-00",
            "expiry_date": "2023-04-00",
            "total_of_checks": "4"
        },
        "member_details": [
            {
                "member_name": "عبدالله ماججد آل علي",
                "nationality": "United Arab Emirates",
                "role": "شريك",
                "share": "51"
            },
            {
                "member_name": "Al-Ali",
                "nationality": "اات العربية المتحدة",
                "role": "Partner",
                "share": "51"
            },
            {
                "member_name": "كانيعزيز  حاساينار",
                "nationality": "India",
                "role": "شريك",
                "share": "49"
            },
            {
                "member_name": "AZEEZ  HASSAINAR",
                "nationality": "الهند",
                "role": "Partner",
                "share": "49"
            },
            {
                "member_name": "كانياليز  حاساينار",
                "nationality": "India",
                "role": "مدير",
                "share": "0"
            },
            {
                "member_name": "AZEEZ  HASSAINAR",
                "nationality": "الهند",
                "role": "Manager",
                "share": "0"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid License

Authentication Error

Missing Parameters

{
    "status_code": 400,
    "success": false,
    "message": "Invalid license number or type",
    "message_code": "invalid_license"
}

This error occurs when the provided license number or type is invalid or doesn't exist in the DED database.

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

Cache license verification results to improve performance for repeated lookups

Implement proper validation for license numbers before making API calls

Display license expiry information prominently to alert users of upcoming renewals

Provide clear error messages to end-users when verification fails

Code Samples

cURL

Python

Node.js

Related APIs

UAE Emirates ID Verification - Verifies Emirates ID details for individuals

UAE Business Verification - Comprehensive business verification including trade license and company details

UAE Address Verification - Verifies physical addresses in the UAE

Compliance and Legal Considerations

This API provides access to official DED license information. Users must ensure they have proper authorization to access this data and comply with UAE data protection regulations. The information should only be used for legitimate business purposes such as KYC, due diligence, or regulatory compliance. Unauthorized use or distribution of this data may violate UAE privacy laws.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/uae-ded/license-verification' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "ded_licence_number": "35343", "ded_licence_type": "commercial" }'

{ "data": { "client_id": "uae_ded_license_qzpiJhaYfuKdCkkZqotQ", "ded_license_number": "12345", "ded_license_type": "commercial", "trade_name": "M R L.L.C", "license_status": "Approved", "issue_date": "2022-10-13", "expiry_date": "2023-10-12", "registration_number": "RN - 18520", "activities": [ "Typing and Documents Photocopying Services", "Travel Tickets Selling" ], "commercial_tenancy_contract": { "property_name": "ععبدالله صالح المدنى", "landlord_name": "عدن عبدالله صالح المدنى", "tenant_name": "Abdulla", "rent_amount_yearly": "30000", "start_date": "2022-05-00", "expiry_date": "2023-04-00", "total_of_checks": "4" }, "member_details": [ { "member_name": "عبدالله ماججد آل علي", "nationality": "United Arab Emirates", "role": "شريك", "share": "51" }, { "member_name": "Al-Ali", "nationality": "اات العربية المتحدة", "role": "Partner", "share": "51" }, { "member_name": "كانيعزيز حاساينار", "nationality": "India", "role": "شريك", "share": "49" }, { "member_name": "AZEEZ HASSAINAR", "nationality": "الهند", "role": "Partner", "share": "49" }, { "member_name": "كانياليز حاساينار", "nationality": "India", "role": "مدير", "share": "0" }, { "member_name": "AZEEZ HASSAINAR", "nationality": "الهند", "role": "Manager", "share": "0" } ] }, "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 ********************

DED License Verification

DED License Verification#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Commercial Tenancy Contract Object#

Member Details Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

DED License Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Commercial Tenancy Contract Object

Member Details Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples