Skip to main content

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.

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.