by Profiden

Digilocker Fetch Details

Identity & KYC

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 https://app.emver.io/api/sandbox/v1/digilocker-fetch-details
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json

Request parameters

FieldTypeDescription
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"
}'

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/json

Request parameters

FieldRequiredDescription
digilocker_transaction_idYesTransaction 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.

statusMeaning
200Verification successful
422Invalid or missing input parameters
500Source unavailable - retry later