---
title: "Check if a DigiLocker account exists"
method: POST
path: "/v1/kyc/digilocker/account-lookup"
tags: ["KYC"]
---

# Check if a DigiLocker account exists

`POST /v1/kyc/digilocker/account-lookup`

Check whether a mobile number or Aadhaar number is already registered
with DigiLocker. This is a pre-consent lookup: it helps you decide
whether to start the user in `signin` or `signup` flow.

Provide exactly one of `aadhaar_number` or `mobile`.

**Credits:** Free.

## Request body

- object
  - `aadhaar_number` string — 12-digit Aadhaar number.
  - `mobile` string — 10-digit Indian mobile number.
  - `reference_id` string — Optional caller-side request identifier.

## Response `200`

Account lookup result

- object
  - `status` string
  - `registered` boolean — Whether the identifier has a DigiLocker account.
  - `digilocker_id` string, nullable — DigiLocker username if registered, null otherwise.
  - `suggested_user_flow` 'signin' | 'signup'
  - `reference_id` string, nullable
  - `next_step` object
    - `action` string
    - `message` string
    - `endpoint` string

## Other responses

- `400` — Validation error
- `401` — Unauthorized. This can happen if the `x-api-key` header is missing.

---

[API](https://skmtc.net/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2.md) · [All operations](https://skmtc.net/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casparser/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/revisions/c9918aebb2de/schema)