HTTP/Error Codes

api error handling and resolution to support smooth integration and effective troubleshooting, this section provides a list of http error codes that may be returned by the data zoo kyc data api these status codes follow standard http conventions and are intended to help developers quickly identify and address issues during implementation and ongoing use api responses success success code description 200 ok indicates that the request was successfully received, understood, and processed by the server error each code is accompanied by possible causes and suggested resolutions error code description possible causes 400 bad request indicates that the server cannot or will not process the request due to something that is perceived to be an error from client side ▪️invalid json or malformed request body ▪️missing required query parameters or headers ▪️invalid values or formats (e g , wrong data type) ▪️incorrect content type (e g , sending text/plain when application/json is expected) example, 401 unauthorized the request failed as valid authentication credentials for the target resource no credentials were provided, or the credentials provided (e g api key, token, username/password) are invalid or expired example, 403 forbidden indicates that the client’s identity may be known, but they do not have permission to access the requested resource ▪️the user is authenticated but lacks required permissions or roles ▪️the resource is restricted (e g , admin only access) ▪️ip address or region has been blocked ▪️access is intentionally denied due to policy or configuration 404 not found indicates that the server is reachable, but the specific url or resource does not exist or could not be found ▪️incorrect url or endpoint path ▪️api version mismatch or deprecated endpoint 405 method not allowed occurs when a client sends a request where the method is not permitted for the target url only post method is allowed 500 internal server error server failed to process the request due to a problem on the server side can be triggered by a wide range of issues it indicates that something went wrong on the server, but the exact cause is not specified in the response 503 service unavailable indicates the server is currently unable to handle the request due to temporary overload, maintenance, or downtime ▪️server under high load or experiencing traffic spikes ▪️scheduled maintenance 522 origin connection time out indicates the request was aborted due to connection issue common causes of a 522 error include an overloaded origin server, firewall or security settings blocking cloudflare, long running processes, or network issues between cloudflare and the server submit a support ticket if the issue persists or further assistance is required, submit a support ticket here