> For the complete documentation index, see [llms.txt](https://docs.tutelar.io/tutelar-api-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tutelar.io/tutelar-api-document/kyc-verification/document-verification/uae/emirates-id-verification.md).

# Emirates ID Verification

The Emirates ID Verification API allows users to verify the identity and details associated with an Emirates ID card number issued in the UAE.

#### Submit Document

## uae\_eid

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/kyc/identity/uae_eid`

### Post parameters description is given below,

<table><thead><tr><th width="197">Post Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th width="235.63671875">Description</th></tr></thead><tbody><tr><td>id_number </td><td>String </td><td>Yes </td><td>TRN number</td></tr><tr><td>date_of_birth</td><td>String </td><td>Yes </td><td>Date of birth <br>( format yyyy-mm-dd) </td></tr><tr><td>current_nationality</td><td>String </td><td>Yes </td><td>Current nationality code<br>UAE - united_arab_emirates</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "id_number": "784198066113592",
    "date_of_birth": "1980-11-12",
    "current_nationality": "united_arab_emirates"
}
```

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "6e0a8534-ab7a-4cac-886c-cf42123399a0",
    "status": "completed",
    "result": {
        "emiratesIdNumber": "784196225985074",
        "dateOfBirth": "1962-08-09",
        "currentNationality": "united_arab_emirates",
        "issueDate": "2021-07-25",
        "expiryDate": "2026-07-24",
        "eidCardNumber": "106784945"
    },
    "requested_at": "2026-01-27T14:23:05.003Z",
    "completed_at": "2026-01-27T14:23:31.351Z"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "db47ada5-c56f-42a9-b731-37c2fbcf7545",
    "status": "in_progress",
    "requested_at": "2026-01-27T09:35:53.893Z"
}
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "ID Number should not be empty",
        "field": "id_number",
        "code": "BAD_REQUEST"
    }
}, 
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Date of Birth should not be empty",
        "field": "date_of_birth",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid date of birth format. Use YYYY-MM-DD.",
        "field": "date_of_birth",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Nationality should not be empty",
        "field": "current_nationality",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid nationality, Please refer docs for more info on supported nationality codes",
        "field": "current_nationality",
        "code": "BAD_REQUEST"
    }
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "db47ada5-c56f-42a9-b731-37c2fbcf7545",
    "status": "failed",
    "error": {
        "message": "Invalid ID Number.",
        "code": "ERROR"
    },
    "requested_at": "2026-01-27T09:35:53.893Z",
    "completed_at": "2026-01-27T09:35:59.831Z"
}
```

{% endtab %}
{% endtabs %}

#### Check Document Status

## Get document details

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/kyc/identity/uae_eid`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Document reference id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "6e0a8534-ab7a-4cac-886c-cf42123399a0",
    "status": "completed",
    "result": {
        "emiratesIdNumber": "784196225985074",
        "dateOfBirth": "1962-08-09",
        "currentNationality": "united_arab_emirates",
        "issueDate": "2021-07-25",
        "expiryDate": "2026-07-24",
        "eidCardNumber": "106784945"
    },
    "requested_at": "2026-01-27T14:23:05.003Z",
    "completed_at": "2026-01-27T14:23:31.351Z"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "db47ada5-c56f-42a9-b731-37c2fbcf7545",
    "status": "in_progress",
    "requested_at": "2026-01-27T09:35:53.893Z"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "db47ada5-c56f-42a9-b731-37c2fbcf7545",
    "status": "failed",
    "error": {
        "message": "Invalid ID Number.",
        "code": "ERROR"
    },
    "requested_at": "2026-01-27T09:35:53.893Z",
    "completed_at": "2026-01-27T09:35:59.831Z"
}
```

{% endtab %}
{% endtabs %}