---
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`

## Request

- Base URL: `https://api.casparser.in`
- URL: `https://api.casparser.in/v1/kyc/digilocker/account-lookup`
- Auth: API key in header `x-api-key`

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.

## Changes

- **2026-09-13** `cf1b57c0f2f7`: 1 warning
  - the optional response header `X-Request-ID` removed for the status `401`
- **2026-08-30** `a38ebe1b68cb`: 1 info
  - the endpoint scheme security `AccessTokenAuth` was removed from the API
- **2026-07-12** `c74b9ecd5b53`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/changes/v1/kyc/digilocker/account-lookup/post.md)

---

[API](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2.md) - [All operations](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/llms.txt) - [OpenAPI document](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/revisions/9d8f1445bad3?raw)
