This section provides a comprehensive overview of the potential error codes returned by the Authyo API, detailing their meanings, possible causes, and recommended corrective actionsOverview of HTTP Status Codes#
The Authyo API returns standard HTTP status codes in its responses to reflect the outcome of your requests. Here's a breakdown:2xx - Success: Signals that the request was successfully received, understood, and processed.
4xx - Client Errors: Indicates an issue with the client's request.
5xx - Server Errors: Reflects problems on the Authyo server side.
Detailed Error Codes Overview#
Below is a comprehensive table outlining the specific error codes, their descriptions, common causes, and recommended solutions:Error Code | Description | Common Causes | Recommended Solution |
---|
400 | Bad Request | Incorrect syntax or missing parameters | Review the request syntax and ensure all required fields are properly formatted. |
401 | Unauthorized | Invalid or missing authentication credentials | Confirm that your clientId and clientSecret are correctly included and valid. |
403 | Forbidden | Insufficient permissions | Check whether your API key has the necessary permissions for the requested operation. |
404 | Not Found | Incorrect endpoint URL or nonexistent resource | Double-check the endpoint URL and verify the resource exists. |
429 | Too Many Requests | API rate limit exceeded | Reduce the frequency of requests and consider implementing exponential backoff for retries. |
500 | Internal Server Error | Server-side issues | Retry the request, and if the problem persists, reach out to support. |
503 | Service Unavailable | Server overload or ongoing maintenance | Wait and try again later. Check the Status Page for any active issues. |
Need More Help?#
If the issues you're encountering are not addressed by this guide or you need more detailed assistance, feel free to get in touch with our support team. We are dedicated to providing you with a smooth experience using the Authyo API. Modified at 2025-05-27 09:39:40