Skip to main content
When you fetch a document using the EntityLocker API or EntityLocker SDK, 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 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

ElementAttributeDescription
Certificatetype, numberDocument type (GSTND), GSTIN number
CertificateissueDate, validFromDateRegistration and validity dates
IssuedBy > OrganizationnameIssuing authority — Goods and Services Tax Network
IssuedTo > OrganizationnameRegistered business name
IssuedTo > Organization > Addresslocality, district, state, pinBusiness address details
GSTNDetailstaxpayerTypeTaxpayer classification (Regular, Composition, etc.)
GSTNDetailsgstidentificationNumberFull GSTIN
GSTNDetailslegalnameofBusinessLegal name as registered
GSTNDetailsconstitutionofBusinessBusiness structure (Private Limited, LLP, etc.)
GSTNDetailsstateJurisdictionAssigned state-level tax jurisdiction

​
Udyam Certificate (UDCER)

The Udyam Certificate XML contains MSME registration details including enterprise classification, NIC codes, and unit information. 
<?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

ElementAttributeDescription
Certificatetype, number, statusDocument type (UDCER), Udyam registration number, status
IssuedBy > OrganizationnameIssuing authority — Ministry of MSME
IssuedTo > Enterprisename, phone, emailEnterprise identity and contact details
IssuedTo > Enterprise > AddressflatDoorBlockNo, nameOfPremisesBuilding, city, state, pinRegistered office address
UdyamRegistrationCertificateudyamRegNo, dateOfRegRegistration number and date
UdyamRegistrationCertificatemajorActivityPrimary activity type (Services / Manufacturing)
UdyamRegistrationCertificateenterpreneurCategoryEntrepreneur category (General, SC, ST, OBC, etc.)
TypeOfEnterpriseEnterprise1..3 > typeClassification across financial years (Micro / Small / Medium)
NameOfUnitsUnit1..N > nameNames of registered business units
NationalIndustryClassificationnic2Digit, nic4Digit, nic5DigitNIC 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.