> 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/uae-trn-verification.md).

# UAE TRN Verification

The UAE TRN Verification API allows users to verify the Tax Registration Number (TRN) of businesses registered for VAT in the UAE.

#### Submit Document

## uae\_trn

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

### 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>Description</th></tr></thead><tbody><tr><td>trn_number </td><td>String </td><td>Yes </td><td>TRN number</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "trn_number": "100529144600008"
}   
```

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

```json
{
  "success": true,
  "code": 200,
  "message": "The request has been successfully completed.",
  "reference_id": "b8606981-43f8-4c30-8e14-4af3c493cb87",
  "status": "completed",
  "result": {
    "trnNumber": "100529144600008",
    "legalName": "Square General Transport L.L.C",
    "legalNameList": [
      "Square General Transport L.L.C",
      "Square General Precast L.L.C.",
      "Square General Contracting Company - L L C"
    ],
    "trnStatus": true
  },
  "requested_at": "2026-01-27T09:29:31.470Z",
  "completed_at": "2026-01-27T09:29:37.106Z"
}
```

{% 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": "TRN should not be empty",
        "field": "trn_number",
        "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/merchant/uae_trn`

### 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": "b8606981-43f8-4c30-8e14-4af3c493cb87",
  "status": "completed",
  "result": {
    "trnNumber": "100529144600008",
    "legalName": "Square General Transport L.L.C",
    "legalNameList": [
      "Square General Transport L.L.C",
      "Square General Precast L.L.C.",
      "Square General Contracting Company - L L C"
    ],
    "trnStatus": true
  },
  "requested_at": "2026-01-27T09:29:31.470Z",
  "completed_at": "2026-01-27T09:29:37.106Z"
}
```

{% 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 %}