Digilocker Fetch Details
Identity & KYCStep 2 of DigiLocker KYC - after the customer completes consent, fetches the verified Aadhaar e-KYC details using the transaction_id returned by the Digilocker API.
Endpoint
POST
https://app.emver.io/api/sandbox/v1/digilocker-fetch-details
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json
Request parameters
| Field | Type | Description |
|---|---|---|
digilocker_transaction_id
required
|
string | Transaction ID transaction_id returned by the Digilocker API |
Example request
cURL
curl -X POST https://app.emver.io/api/sandbox/v1/digilocker-fetch-details \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"digilocker_transaction_id": "string"
}'
import requests
response = requests.post(
"https://app.emver.io/api/sandbox/v1/digilocker-fetch-details",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
},
json={
"digilocker_transaction_id": "string"
},
timeout=60,
)
response.raise_for_status()
data = response.json()
const response = await fetch("https://app.emver.io/api/sandbox/v1/digilocker-fetch-details", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
"Accept": "application/json",
},
body: JSON.stringify({
"digilocker_transaction_id": "string"
}),
});
const data = await response.json();
$response = Http::withToken('YOUR_API_KEY')
->acceptJson()
->post('https://app.emver.io/api/sandbox/v1/digilocker-fetch-details', {
"digilocker_transaction_id": "string"
});
$data = $response->json();
Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.
Response
Structure · 200
{
"status": INTEGER,
"message": STRING
}
Example · 200
{
"status": 200,
"message": "string"
}
Error · 4xx / 5xx
{
"status": INTEGER,
"message": STRING
}
See Errors & status codes for what each status means and which calls are billed.
About this API
Digilocker Fetch Details
Step 2 of DigiLocker KYC - after the customer completes consent, fetches the verified Aadhaar e-KYC details using the transaction_id returned by the Digilocker API.
Endpoint
POST /api/v1/digilocker-fetch-details
Content-Type: application/jsonRequest parameters
| Field | Required | Description |
|---|---|---|
digilocker_transaction_id | Yes | Transaction ID - transaction_id returned by the Digilocker API. Example: Transaction ID from DigiLocker link step |
Sample request
{
"digilocker_transaction_id": "Transaction ID from DigiLocker link step"
}Sample success response
{
"status": 200,
"message": "Verification successful",
"data": {
"kyc_status": "...",
"masked_aadhaar": "...",
"name": "...",
"gender": "...",
"dob": "...",
"care_of": "...",
"address": {
"house": "...",
"street": "...",
"landmark": "...",
"locality": "...",
"post_office": "...",
"district": "...",
"sub_district": "...",
"city": "...",
"pincode": "...",
"state": "...",
"country": "..."
},
"photo": "..."
}
}Sample error response
{
"status": 404,
"message": "No record found for the given input"
}Response status codes
The status field in the response body indicates the verification outcome.
| status | Meaning |
|---|---|
200 | Verification successful |
422 | Invalid or missing input parameters |
500 | Source unavailable - retry later |