---
title: "Fetch Aadhaar XML from DigiLocker"
method: POST
path: "/verify/digilocker/fetch_aadhaar"
tags: ["DigiLocker"]
---

# Fetch Aadhaar XML from DigiLocker

`POST /verify/digilocker/fetch_aadhaar`

Fetches the user's Aadhaar XML document from DigiLocker and returns it as a file.

| HTTP Status | Code  | Reason               | Message                      | Merchant Action                |
|-------------|-------|----------------------|------------------------------|-------------------------------|
| 200         | 1004  | DOC_RETRIEVED        | Aadhaar retrieved successfully. | Proceed with verification.     |
| 200         | 2007  | DOC_NOT_FOUND        | Aadhaar not issued.          | Offer alternate KYC document.  |
| 200         | 2005  | CONSENT_NOT_PROVIDED | User denied Aadhaar access.  | Retry/alternate doc.           |
| 200         | 2009  | DOC_UNAVAILABLE      | Aadhaar temporarily unavailable. | Retry later.                   |
| 400         | 2010  | SESSION_EXPIRED      | DigiLocker session expired.  | Restart flow.                  |

## Request body

- DigilockerFetchAadhaarRequest
  - `reference_key` string, required — Reference key obtained from /digilocker/get_reference.

## Response `200`

Aadhaar XML retrieved successfully

## Other responses

- `400` — Invalid request or missing/invalid reference_key
- `401` — Unauthorized - missing/invalid API key or client id
- `404` — Reference key not found or document unavailable
- `500` — Internal server error

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)