Skip to main content
GET
Get KYC Status

Get KYC Status

Returns the current KYC verification status for a user.

Request

Response

Any method the user has not completed is returned as { "verified": false } with no other fields.
Fields with no value are omitted, not returned as null. In particular, before DigiLocker completes, the digilocker block is just { "status": "pending" } — with no verified key at all. Treat a missing verified as false.
The declaration is not part of this response — it’s submitted via Submit Declaration.
Submitting the declaration does not immediately recompute the aggregate status — it can remain in_progress even once every requirement is met. Call POST /kyc/refresh (below) after the final step to settle the status.

Status Values

level is none, basic, or enhanced. It becomes basic when status is verified.

Refresh KYC Status

Recomputes the aggregate status from the underlying verifications. Use this if a status looks stale after a verification completed.