> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Sample Responses

> Sample XML structures returned by EntityLocker for GSTN Details and Udyam Certificate documents

When you fetch a document using the [EntityLocker API](/api-reference/kyc/entitylocker/endpoints/fetch_document) or [EntityLocker SDK](/api-reference/kyc/entitylocker/sdk/endpoints/fetch_document), the response contains a `url` to download the document file. For XML format documents, the downloaded file is a signed XML certificate issued via EntityLocker.

The XML structure varies by document type. Below are sample XML responses for commonly fetched business documents.

## GSTN Details (GSTND)

The GSTN Details XML contains GST registration information including taxpayer type, legal name, constitution of business, and jurisdiction details.

```xml theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<Certificate language="99" name="GSTN Details" type="GSTND"
             number="00XXXXX0000X0XX" issuedAt=""
             issueDate="01-01-2023" validFromDate="01-04-2023" status="">
  <IssuedBy>
    <Organization name="Goods and Services Tax Network" code="" tin="" uid="" type="CG">
      <Address type="official" line1="" line2="" house="" landmark=""
               locality="" vtc="" district="" pin="" state="" country="IN"/>
    </Organization>
  </IssuedBy>
  <IssuedTo>
    <Organization uid="" title=""
                  name="SAMPLE ENTERPRISE PRIVATE LIMITED"
                  phone="" email="">
      <Address type="" line1="Sample City" line2="" house="" landmark=""
               locality="SAMPLE LOCALITY" vtc="" district="Sample District"
               pin="000000" state="Gujarat" country="IN"/>
      <Photo/>
    </Organization>
  </IssuedTo>
  <CertificateData>
    <GSTNDetails taxpayerType="Regular"
                 gstidentificationNumber="00XXXXX0000X0XX"
                 dateofRegistration="01-01-2023"
                 lastupdatedDate="01-04-2023"
                 tradeName=""
                 legalnameofBusiness="SAMPLE ENTERPRISE PRIVATE LIMITED"
                 constitutionofBusiness="Private Limited Company"
                 stateJurisdiction="Sample Jurisdiction"/>
  </CertificateData>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    <!-- Digital signature issued by National e-Governance Division -->
  </Signature>
</Certificate>
```

### Key fields

| Element                             | Attribute                              | Description                                          |
| ----------------------------------- | -------------------------------------- | ---------------------------------------------------- |
| `Certificate`                       | `type`, `number`                       | Document type (`GSTND`), GSTIN number                |
| `Certificate`                       | `issueDate`, `validFromDate`           | Registration and validity dates                      |
| `IssuedBy > Organization`           | `name`                                 | Issuing authority — Goods and Services Tax Network   |
| `IssuedTo > Organization`           | `name`                                 | Registered business name                             |
| `IssuedTo > Organization > Address` | `locality`, `district`, `state`, `pin` | Business address details                             |
| `GSTNDetails`                       | `taxpayerType`                         | Taxpayer classification (Regular, Composition, etc.) |
| `GSTNDetails`                       | `gstidentificationNumber`              | Full GSTIN                                           |
| `GSTNDetails`                       | `legalnameofBusiness`                  | Legal name as registered                             |
| `GSTNDetails`                       | `constitutionofBusiness`               | Business structure (Private Limited, LLP, etc.)      |
| `GSTNDetails`                       | `stateJurisdiction`                    | Assigned state-level tax jurisdiction                |

***

## Udyam Certificate (UDCER)

The Udyam Certificate XML contains MSME registration details including enterprise classification, NIC codes, and unit information.

```xml theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<Certificate language="99" name="Udaym Certificate" type="UDCER"
             number="UDYAM-XX-00-0000000" issuedAt=""
             issueDate="01-01-2023" validFromDate="" status="A">
  <IssuedBy>
    <Organization name="Ministry of Micro, Small and Medium Enterprises"
                  code="" tin="" uid="" type="CG">
      <Address type="official" line1="" line2="" house="" landmark=""
               locality="" vtc="" district="SAMPLE DISTRICT"
               pin="000000" state="GUJARAT" country="IN"/>
    </Organization>
  </IssuedBy>
  <IssuedTo>
    <Enterprise uid="" title=""
                name="M/S SAMPLE ENTERPRISE PRIVATE LIMITED"
                dob="dd-mm-yyyy" age="" swd="" swdIndicator=""
                gender="" maritalStatus="" religion=""
                phone="0000000000" email="sample@example.com">
      <Address type="" line1="" line2=""
               flatDoorBlockNo="X-000"
               nameOfPremisesBuilding="SAMPLE TOWER"
               block="BLOCK X"
               roadStreetLane="SAMPLE ROAD"
               vtc="SAMPLE CITY" district="SAMPLE DISTRICT"
               city="SAMPLE CITY" pin="000000"
               state="GUJARAT" country="IN"/>
      <Photo/>
    </Enterprise>
  </IssuedTo>
  <CertificateData>
    <UdyamRegistrationCertificate
        udyamRegNo="UDYAM-XX-00-0000000"
        dateOfReg="01-01-2023"
        majorActivity="Services"
        dateOfIncorporation="01-01-2023"
        dateOfCommencement="01-01-2023"
        enterpreneurCategory="General">
      <TypeOfEnterprise>
        <Enterprise1 type="Micro ( Based on FY 2022-23 )"/>
        <Enterprise2 type="Micro ( During FY 2021-22 )"/>
        <Enterprise3 type="Micro ( During FY 2020-21 )"/>
      </TypeOfEnterprise>
      <NameOfUnits>
        <Unit1 name="M/S SAMPLE ENTERPRISE PRIVATE LIMITED"/>
      </NameOfUnits>
      <NationalIndustryClassification>
        <Classification1
            nic2Digit="63 - Information service activities"
            nic4Digit="6399 - Other information service activities n.e.c."
            nic5Digit="63999 - Other information service activities n.e.c."
            activity="Services"/>
        <Classification2
            nic2Digit="64 - Financial service activities, except insurance and pension funding"
            nic4Digit="6499 - Other financial service activities, except insurance and pension funding activities, n.e.c."
            nic5Digit="64990 - Other financial service activities, except insurance and pension funding activities, n.e.c"
            activity="Services"/>
      </NationalIndustryClassification>
    </UdyamRegistrationCertificate>
  </CertificateData>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    <!-- Digital signature issued by National e-Governance Division -->
  </Signature>
</Certificate>
```

### Key fields

| Element                           | Attribute                                                           | Description                                                    |
| --------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------- |
| `Certificate`                     | `type`, `number`, `status`                                          | Document type (`UDCER`), Udyam registration number, status     |
| `IssuedBy > Organization`         | `name`                                                              | Issuing authority — Ministry of MSME                           |
| `IssuedTo > Enterprise`           | `name`, `phone`, `email`                                            | Enterprise identity and contact details                        |
| `IssuedTo > Enterprise > Address` | `flatDoorBlockNo`, `nameOfPremisesBuilding`, `city`, `state`, `pin` | Registered office address                                      |
| `UdyamRegistrationCertificate`    | `udyamRegNo`, `dateOfReg`                                           | Registration number and date                                   |
| `UdyamRegistrationCertificate`    | `majorActivity`                                                     | Primary activity type (Services / Manufacturing)               |
| `UdyamRegistrationCertificate`    | `enterpreneurCategory`                                              | Entrepreneur category (General, SC, ST, OBC, etc.)             |
| `TypeOfEnterprise`                | `Enterprise1..3 > type`                                             | Classification across financial years (Micro / Small / Medium) |
| `NameOfUnits`                     | `Unit1..N > name`                                                   | Names of registered business units                             |
| `NationalIndustryClassification`  | `nic2Digit`, `nic4Digit`, `nic5Digit`                               | NIC codes describing business activities                       |

***

## Digital signature verification

All XML responses are digitally signed by **National e-Governance Division** using an enveloped XML signature (`xmldsig#`). Each document includes:

* A `<Signature>` block with the signed digest and signature value
* An `<X509Certificate>` containing the signer's public certificate

You can verify document authenticity by validating the `<Signature>` block against the X.509 certificate embedded in the XML.