Skip to main content

How do I handle API errors and response codes?

The Verto API uses standard HTTP status codes and a consistent error response format.

1. Error response format All error responses return: { error: { code, message, details } }


2. Common status codes 200/201 success. 400 bad request. 401 invalid API key. 403 forbidden. 404 not found. 409 conflict. 422 unprocessable. 429 rate limit. 500 internal error.

💡 Tip: Retry only on 429, 500, 502, 503, and 504. Do not retry on 400, 401, 403, 404, or 422.


3. For 500-series errors, implement exponential back-off.


Related articles:

Did this answer your question?