> ## 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 DigiLocker for Aadhaar, PAN, and Driving License documents

When you fetch a document using the [DigiLocker API](/api-reference/kyc/digilocker/endpoints/fetch_document) or [DigiLocker SDK](/api-reference/kyc/digilocker-sdk/endpoints/get-document), 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 theme={null}
<?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                  |

<Info>
  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.
</Info>

***

## PAN (PANCR)

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

```xml theme={null}
<?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 theme={null}
<?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.