DocumentationAPI Reference
General reference, eKYB Reference / eKYB Prefill Coverage

United Arab Emirates

United Arab Emirates

eKYB Prefill in the United Arab Emirates leverages UAE official business registry data to automatically retrieve and populate business information based on a company's registration number, including the business name, registered address, entity type, registration status, and incorporation date, without requiring manual input from the user.

Source

Source Description
AE_KYB_PREFILL Returns matching UAE business details from official business registry data for prefill.

Direct API approach

For general integration notes and shared response semantics, see the eKYB Prefill API Reference.

All module configurations and user data can be forwarded directly in the request for performing a Prefill lookup. This overrides existing configuration and data collected about the user.

Endpoint

POST /omni/externalVerification/ekyb-prefill

Request parameters

Parameter Required Description
plugins Mandatory String array. Must be ["ekyb-prefill"]. Specifies the Prefill flow.
source Mandatory String. Must be AE_KYB_PREFILL. Identifies the Prefill source.
country Mandatory String. Two-letter Alpha-2 country code. Must be AE.
taxId Mandatory String. UAE company registration number. Format varies by emirate and free zone — no format validation is applied. See Tax ID formats for details.
businessName Optional String. Registered name of the business. When provided, may improve match accuracy.

Tax ID formats

UAE registration number formats vary by emirate and free zone. No format validation is applied — all formats are accepted as submitted.

Format Example
DMCC Trade License DMCCXXXXXX
DIFC License Format varies
JLT License DMCC-XXXXXX

Note

UAE registration number formats vary by emirate and free zone — no format validation is applied to taxId. All formats are accepted as-is (for example, 000001911, DMCC2429, 6099). Address data may be returned in Arabic script and is automatically translated to English.

Sample request

{
    "plugins": ["ekyb-prefill"],
    "source": "AE_KYB_PREFILL",
    "country": "AE",
    "taxId": "000000001",
    "businessName": "EXAMPLE COMPANY LLC"
}

Sample response

The Prefill response returns business data retrieved directly from the source of truth. Fields are returned as-is from the source, with address and name translated to English where originally in Arabic script. Fields such as entityType, email, and phoneNumber may be absent depending on which registry the business is resolved against.

{
  "kyb-prefill": [
    {
      "tin": "000000001",
      "name": "EXAMPLE COMPANY LLC",
      "registrationStatus": "Active",
      "entityType": "Unknown",
      "registrationDate": "2021-10-17T13:52:55Z",
      "incorporationDate": "2018-12-23",
      "address": "Unit 1, Floor 1, Example Tower, Example Street, Abu Dhabi, AE-AZ, United Arab Emirates",
      "email": null,
      "phoneNumber": null
    }
  ]
}

Response fields

Key Value Description
tin Registration number The UAE registration number as submitted in the request, confirmed by the source of truth.
name Business name The registered legal name of the business as returned from the source of truth. Names originally in Arabic are automatically translated to English.
registrationStatus Active, Inactive, Unknown Current registration status of the business. See Registration status values for details.
entityType Entity type The legal entity type of the business as returned from the source of truth (for example, Public, Private Company Limited By Shares, Trading). Returns Unknown when not available.
registrationDate Date The date the company was registered in the source registry, as returned from the source of truth. May not be present for all companies.
incorporationDate Date The date the company was incorporated, as returned from the source of truth. May not be present for all companies.
address Registered address The primary registered address of the business as returned from the source of truth. Addresses originally in Arabic are automatically translated to English. May not be present for all companies.
email Email address The business contact email address registered with the source of truth, if available.
phoneNumber Phone number The business contact phone number registered with the source of truth, if available.

Registration status values

Status Description
Active The company is currently active and registered.
Inactive The company registration is dissolved or inactive.
Unknown The registration status could not be determined.

Error responses

For standard HTTP response codes, see the API Error Response page. UAE Prefill returns the following country-specific 400 errors.

taxId is missing or empty:

{
    "timestamp": 1782851408892,
    "status": 400,
    "error": "Bad Request",
    "message": "must not be blank",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Any mandatory field (plugins, source, or country) is missing:

{
    "timestamp": 1782851468367,
    "status": 400,
    "error": "Bad Request",
    "message": "must not be blank",
    "path": "/omni/externalVerification/ekyb-prefill"
}

No business match is found for the submitted taxId:

{
    "timestamp": 1782851583695,
    "status": 200,
    "message": "No business found matching the provided tax ID.",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Single Session Dashboard results

Prefill results are available on the Business tab in single Session view.

Was this page helpful?