OneKYC API Error Codes

The following Error Codes are returned along with a HTTP Status Code of 4xx or 5xx

Get Partner Token API

HTTP StatusInternal CodeError Cause / Description
4001539Missing client-id or pass-key parameters.
401110Unauthorized; the provided client-id and pass-key parameters are incorrect.
500900Unknown error.

Initiate Flow API

HTTP StatusInternal CodeError Cause / Description
4001539Missing headers or fields (e.g., CLIENT_ID_CAN_NOT_BE_EMPTY or PASS_KEY_CAN_NOT_BE_EMPTY).
401110Invalid Credentials (UNAUTHORIZED).
403110Invalid Onboarding Partner (ONBOARDING_PARTNER_DOES_NOT_BELONG_TO_CLIENT).

Get Submission Result Details API

HTTP StatusInternal CodeError Cause / Description
4001550Missing header parameters (e.g., PARTNER_USER_ID_CAN_NOT_BE_EMPTY).
4001552Submission not found (SUBMISSION_DOES_NOT_EXIST).
4001553Partner session ID does not belong to the given user ID (PARTNER_SESSION_ID_DOES_NOT_BELONG_TO_THE_USER).
401110Unauthorized; incorrect client credentials in header parameters (UNAUTHORIZED).
403903Authorisation error (FORBIDDEN).
500900Unknown error (GENERIC_SERVICE_ERROR).

Get Reference Image API

HTTP StatusInternal CodeError Cause / Description
4xx / 5xxPARTNER_ERROR_CODEBecause this API is hosted by the Partner, any non-200 HTTP response code is considered an error from IAB BE. The specific code and message are generated by the partner backend.

Partner Callback API

HTTP StatusInternal CodeError Cause / Description
4xx / 5xxPARTNER_ERROR_CODEBecause this API is hosted by the Partner, any non-200 HTTP response code is considered an error from IAB BE. The specific code and message are generated by the partner backend.