Docs How-to guides References Error messages General error messages

General error messages

Posted 2025-01-03 | Updated 2025-02-17

Content of this guide

Overview

This guide dives into the most common HTTP general error codes for KYC API V2, offering insights into what they mean, why they occur, and how to effectively address them.

/api/v2

Error code and message Description
400 ERR_MISSING_TENANT_ID Request not allowed without x-tenant-id in request header.
401 ERR_GENERAL_INVALID_AUTHORIZATION No Authentication parameters provided
404 ERR_CALLBACK_SETTING_NOT_FOUND There is no callback setting for the given input parameters!
404 ERR_GENERAL_INVALID_URL This endpoint does not exist
404 ERR_KOMPANY_ID_NOT_FOUND Kompany ID not found.
404 ERR_KOMPANY_MESSAGE_NOT_FOUND There is no kompany message provided for the given input parameters.
404 ERR_SANDBOX_CONFIG_NOT_FOUND A sandbox configuration was not found with the given request
429 ERR_GENERAL_LIMIT_EXCEEDED You have no access to this feature or you have exceeded the set limits for this endpoint.
500 ERR_SANDBOX_CONFIG_ERROR Error with sandbox configuration.
500 ERR_GENERAL_SERVER_ERROR An unexpected Error appeared during request processing, Please try again!

/system/kompanyMessages

Error code and message Description
400 ERR_KOMPANY_MESSAGES_BAD_REQUEST The POST sent with the request is invalid! Please check documentation.
400 ERR_KOMPANY_MESSAGES_INVALID_PARAM The post body that you provided was invalid. Please check input params based on swagger documentation.

/system/coverage

Error code and message Description
400 ERR_SYSTEM_COVERAGE_CHANGES_BAD_REQUEST Bad request for system coverage changes.
400 ERR_SYSTEM_COVERAGE_BAD_REQUEST Bad request for system coverage query.
500 ERR_SYSTEM_COVERAGE_CHANGES_INTERNAL_SERVER_ERROR Internal server error during system coverage changes processing.
Next