Sample Responses

When you fetch a document using the DigiLocker API or DigiLocker SDK, the response contains a url to download the document file. For XML format documents, the downloaded file is a signed XML certificate issued by DigiLocker. The XML structure varies by document type. Below are sample XML responses for the most commonly fetched documents.

Aadhaar (ADHAR)

The Aadhaar XML uses a KycRes envelope structure. The UidData element contains Poi (Proof of Identity), Poa (Proof of Address), LData (local language data), and Pht (base64-encoded photo).

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Certificate>
  <CertificateData>
    <KycRes code="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" ret="Y"
            ts="2026-01-15T12:00:00.000+05:30"
            ttl="2027-01-15T12:00:00"
            txn="UKC:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx">
      <UidData tkn="" uid="xxxxxxxx1234">
        <Poi dob="01-01-1990" gender="M" name="SAMPLE NAME"/>
        <Poa co="C/O SAMPLE GUARDIAN"
             country="India"
             dist="Sample District"
             house="A 101, Sample Apartment"
             lm="Nr Sample Landmark"
             loc="Sample Locality"
             pc="380001"
             po="Sample Post Office"
             state="Gujarat"
             subdist="Sample Sub-District"
             vtc="Sample City"/>
        <LData co="C/O सैंपल गार्जियन"
               country=" "
               dist="સેમ્પલ ડિસ્ટ્રિક્ટ"
               house="એ 101, સેમ્પલ એપાર્ટમેન્ટ"
               lang="06"
               lm="સેમ્પલ લેન્ડમાર્ક પાસે"
               loc="સેમ્પલ લોકેલિટી"
               name="सैंपल नाम"
               pc="380001"
               state="ગુજરાત"
               vtc="સેમ્પલ શહેર"/>
        <Pht><!-- Base64-encoded JPEG photo --></Pht>
      </UidData>
    </KycRes>
  </CertificateData>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    <!-- Digital signature issued by Digital India Corporation -->
  </Signature>
</Certificate>

Key fields

Element	Attribute	Description
`UidData`	`uid`	Masked Aadhaar number (last 4 digits visible)
`Poi`	`name`, `dob`, `gender`	Proof of Identity — name, date of birth, gender
`Poa`	`house`, `loc`, `dist`, `state`, `pc`	Proof of Address — full address details
`LData`	`name`, `house`, `dist`, `state`	Address and name in local/regional language
`Pht`	—	Base64-encoded JPEG photograph

The Aadhaar XML structure differs from PAN and Driving License — it uses a KycRes envelope instead of the standard DigiLocker Certificate wrapper with IssuedBy / IssuedTo sections.

PAN (PANCR)

The PAN XML follows the standard DigiLocker Certificate structure with IssuedBy, IssuedTo, and CertificateData sections.

<?xml version="1.0" encoding="utf-8"?>
<Certificate language="99" name="PAN Verification Record" type="PANCR"
             number="XXXPX0000X" issuedAt="DigiLocker"
             issueDate="" validFromDate="" status="A">
  <IssuedBy>
    <Organization name="Income Tax Department" code="" tin="" uid="" type="CG">
      <Address type="" line1="" line2="" house="" landmark=""
               locality="" vtc="" district="" pin="" state="" country="IN"/>
    </Organization>
  </IssuedBy>
  <IssuedTo>
    <Person uid="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" title=""
            name="SAMPLE NAME" dob="01-01-1990" swd=""
            swdIndicator="" gender="MALE" maritalStatus=""
            religion="" phone="" email="">
      <Address type="permanent" line1="" line2="" house="" landmark=""
               locality="" vtc="" district="" pin="" state="" country="IN"/>
      <Photo format=""/>
    </Person>
  </IssuedTo>
  <CertificateData>
    <PAN num="XXXPX0000X" verifiedOn="01-01-2026 12:00:00"/>
  </CertificateData>
  <QRMeta><!-- Base64-encoded QR code PNG --></QRMeta>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    <!-- Digital signature issued by Digital India Corporation -->
  </Signature>
</Certificate>

Key fields

Element	Attribute	Description
`Certificate`	`type`, `number`, `status`	Document type (`PANCR`), PAN number, status (`A` = Active)
`IssuedBy > Organization`	`name`	Issuing authority — Income Tax Department
`IssuedTo > Person`	`name`, `dob`, `gender`	PAN holder’s identity details
`CertificateData > PAN`	`num`, `verifiedOn`	PAN number and verification timestamp
`QRMeta`	—	Base64-encoded PNG of the QR code

Driving License (DRVLC)

The Driving License XML includes license validity, vehicle categories, and both present and permanent addresses.

<?xml version="1.0" encoding="UTF-8"?>
<Certificate language="99" name="Driving License" type="DRVLC"
             number="XX00 00000000000" prevNumber=""
             issuedAt="RTO,SAMPLE-CITY" issueDate="01-01-2020"
             expiryDate="01-01-2040" validFromDate="01-01-2020"
             status="Active">
  <IssuedBy>
    <Organization name="RTO,SAMPLE-CITY" code="" tin="" uid="" type="CG">
      <Address type="" line1="" line2="" house="" landmark=""
               locality="" vtc="" district="" pin="" state="" country="IN"/>
    </Organization>
  </IssuedBy>
  <IssuedTo>
    <Person uid="" uidToken="" aadhaarName="" title=""
            name="SAMPLE NAME" dlConcateName="SAMPLE NAME"
            dlNatName="SAMPLE NAME" dob="01-01-1990" age=""
            swd="SAMPLE GUARDIAN" swdIndicator="M"
            gender="Male" maritalStatus="" religion=""
            phone="" email="">
      <Address type="present"
               line1="SAMPLE ADDRESS LINE 1, SAMPLE CITY, 000000"
               line2="" house="" landmark="" locality=""
               vtc="" district="" pin="" state="" country="IN"/>
      <Address2 type="permanent"
                line1="SAMPLE ADDRESS LINE 1, SAMPLE CITY, 000000"
                line2="" house="" landmark="" locality=""
                vtc="" district="" pin="" state="" country="IN"/>
      <Photo format=""><!-- Base64-encoded JPEG photo --></Photo>
    </Person>
  </IssuedTo>
  <CertificateData>
    <DrivingLicense verifiedOn="01-01-2026 12:00:00">
      <Categories>
        <Category code="NT" abbreviation="MCWG"
                  description="Motor Cycle with Gear(Non Transport)"
                  issueDate="01-01-2020" endorseDate=""/>
        <Category code="NT" abbreviation="LMV"
                  description="LIGHT MOTOR VEHICLE"
                  issueDate="01-01-2025" endorseDate=""/>
      </Categories>
    </DrivingLicense>
  </CertificateData>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    <!-- Digital signature issued by Digital India Corporation -->
  </Signature>
</Certificate>

Key fields

Element	Attribute	Description
`Certificate`	`type`, `number`, `status`	Document type (`DRVLC`), DL number, status
`Certificate`	`issueDate`, `expiryDate`	License validity period
`IssuedBy > Organization`	`name`	Issuing RTO name
`IssuedTo > Person`	`name`, `dob`, `gender`, `swd`	License holder details and guardian name
`Address` / `Address2`	`type`, `line1`	Present and permanent addresses
`Category`	`abbreviation`, `description`, `code`	Vehicle categories — `NT` (Non Transport) / `T` (Transport)
`Photo`	—	Base64-encoded JPEG photograph

Digital signature verification

All XML responses are digitally signed by Digital India Corporation 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.

Aadhaar

Bank

DigiLocker

EntityLocker

MCA

PAN

Annexures

Sample Responses

Aadhaar (ADHAR)

Key fields

PAN (PANCR)

Key fields

Driving License (DRVLC)

Key fields

Digital signature verification

​Aadhaar (ADHAR)

​Key fields

​PAN (PANCR)

​Key fields

​Driving License (DRVLC)

​Key fields

​Digital signature verification

Aadhaar (ADHAR)

Key fields

PAN (PANCR)

Key fields

Driving License (DRVLC)

Key fields

Digital signature verification