---
title: "United Arab Emirates"
url: "https://developer.incode.com/general-reference/united-arab-emirates/"
section: "general-reference"
group: "eKYB Reference / eKYB Prefill Coverage"
version: "v1.1"
status: "live"
---
# 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](/general-reference/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

```json
{
    "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.



```json
{
  "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:

```json
{
    "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:

```json
{
    "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`:

```json
{
    "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](/dashboard-platform-administration/single-session-view/).