KYC Error Codes

Error codes specific to the KYC APIs (PAN Verification, Compliance Status, DigiLocker).

Error response format

All error responses use this structure:

{
  "errorCode": 400,
  "errorType": "proxy",
  "errorMessage": "Invalid PAN"
}

Error codes

Endpoint	Status	Error Message	Description	Resolution
PAN Verification	400	Invalid PAN	PAN format is invalid	Ensure PAN is 10 chars: 5 letters + 4 digits + 1 letter
PAN Verification	400	Invalid Request	Request body malformed	Check JSON body has pan field
Compliance 206AB	400	Invalid PAN	PAN format is invalid	Same as above
DigiLocker Init	400	failed to read request body	Body is missing or malformed	Check JSON body has pinlessVerification
DigiLocker Fetch	400	sessionId expired or invalid	Session expired or wrong	Re-initiate DigiLocker flow
All	401	Invalid Credentials	Token missing or expired	Get a new access token
All	429	Quota Violation	Rate limit exceeded	Wait and retry with exponential backoff
All	500	Internal Server Error	Server error	Retry after delay
All	503	Service Not Available	Upstream service down	Retry with backoff

Related

• Error Handling Guide
• Rate Limits