> 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/india/udyam-aadhaar.md).

# Udyam Aadhaar

#### Submit Document

## ind\_udyam\_aadhaar

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

### Post parameters description is given below,

<table><thead><tr><th width="197">Post Parameter </th><th width="139">Type</th><th width="146">Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>uam_number </td><td>String </td><td>Yes </td><td>Udyam Aadhaar Number</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "uam_number": "UDYAM-MH-33-0006866"
}
```

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "completed",
    "result": {
        "general_details": {
            "applied_date": "2021-05-13",
            "commencement_date": "2021-05-01",
            "date_of_inc": "2021-05-01",
            "dic_name": "THANE",
            "enterprise_name": "M/S UDAN FASHION HUB LLP",
            "enterprise_type": "Micro",
            "major_activity": "Manufacturing",
            "msme_di": "MUMBAI",
            "organization_type": "Limited Liability Partnership",
            "social_category": "General",
            "state": "MAHARASHTRA"
        },
        "official_address": {
            "block": "HENDREPADA",
            "city": "BADLAPUR",
            "district": "THANE",
            "door": "FLAT NO 004",
            "email": "uday.nair75@gmail.com",
            "mobile": "70*****198",
            "name_of_premises": "SHIVAM APARTMENT",
            "pin": "421503",
            "road": "HENDREPADA",
            "state": "MAHARASHTRA",
            "town": "HENDREPADA"
        },
        "nic_details": [
            {
                "nic_details_1": {
                    "activity_type": "Manufacturing",
                    "date": "2021-05-13",
                    "nic_2_digit": "13 - Manufacture of textiles",
                    "nic_4_digit": "1399 - Manufacture of other textiles n.e.c.",
                    "nic_5_digit": "13999 - Manufacture of other textiles/textile products n.e.c."
                }
            }
        ],
        "unit_details": [
            {
                "unit_1": {
                    "block": "HENDREPADA",
                    "building": "SHIVAM APARTMENT",
                    "city": "BADLAPUR",
                    "district": "THANE",
                    "flat": "FLAT NO 004",
                    "pin": "421503",
                    "road": "HENDREPADA",
                    "state": "MAHARASHTRA",
                    "unit_name": "M/S  UDAN FASHION HUB LLP",
                    "village": "HENDREPADA"
                }
            }
        ]
    },
    "requested_at": "2024-04-18T13:11:12.428Z",
    "completed_at": "2024-04-18T13:11:14.000Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "in_progress",
    "requested_at": "2024-04-18T13:11:12.428Z"
}
```

{% endtab %}

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

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid UAM Number",
        "field": "uam_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": "d9a02bb2-1357-49bd-a1ab-94d06f7f419c",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-18T13:14:13.968Z",
    "completed_at": "2024-04-18T13:14:15.000Z"
}
```

{% endtab %}
{% endtabs %}

#### Check Document Status

## Get udayam aadhar details

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

### 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": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "completed",
    "result": {
        "general_details": {
            "applied_date": "2021-05-13",
            "commencement_date": "2021-05-01",
            "date_of_inc": "2021-05-01",
            "dic_name": "THANE",
            "enterprise_name": "M/S UDAN FASHION HUB LLP",
            "enterprise_type": "Micro",
            "major_activity": "Manufacturing",
            "msme_di": "MUMBAI",
            "organization_type": "Limited Liability Partnership",
            "social_category": "General",
            "state": "MAHARASHTRA"
        },
        "official_address": {
            "block": "HENDREPADA",
            "city": "BADLAPUR",
            "district": "THANE",
            "door": "FLAT NO 004",
            "email": "uday.nair75@gmail.com",
            "mobile": "70*****198",
            "name_of_premises": "SHIVAM APARTMENT",
            "pin": "421503",
            "road": "HENDREPADA",
            "state": "MAHARASHTRA",
            "town": "HENDREPADA"
        },
        "nic_details": [
            {
                "nic_details_1": {
                    "activity_type": "Manufacturing",
                    "date": "2021-05-13",
                    "nic_2_digit": "13 - Manufacture of textiles",
                    "nic_4_digit": "1399 - Manufacture of other textiles n.e.c.",
                    "nic_5_digit": "13999 - Manufacture of other textiles/textile products n.e.c."
                }
            }
        ],
        "unit_details": [
            {
                "unit_1": {
                    "block": "HENDREPADA",
                    "building": "SHIVAM APARTMENT",
                    "city": "BADLAPUR",
                    "district": "THANE",
                    "flat": "FLAT NO 004",
                    "pin": "421503",
                    "road": "HENDREPADA",
                    "state": "MAHARASHTRA",
                    "unit_name": "M/S  UDAN FASHION HUB LLP",
                    "village": "HENDREPADA"
                }
            }
        ]
    },
    "requested_at": "2024-04-18T13:11:12.428Z",
    "completed_at": "2024-04-18T13:11:14.000Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "9b2601bd-1f4e-4b55-bdac-4783d43c0d5e",
    "status": "in_progress",
    "requested_at": "2024-04-18T13:11:12.428Z"
}
```

{% endtab %}

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

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "d9a02bb2-1357-49bd-a1ab-94d06f7f419c",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-18T13:14:13.968Z",
    "completed_at": "2024-04-18T13:14:15.000Z"
}
```

{% endtab %}
{% endtabs %}