Error codes

API Errors

When interacting with our HTTP API, it's important to understand the various error codes that may be returned in response to your requests. Error codes are standard HTTP status codes that provide insight into how your requests are being processed and indicate specific types of errors when they occur. Below is an overview of common error codes you might encounter, along with their meanings:

4xx Client Error Codes

These errors are the result of issues on the client side (i.e., the request sent to the server).

400 Bad Request

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).

401 Unauthorized

Authentication is required, and the request has failed to provide it.

402 Payment Required

Insufficient credits in the account.

404 Not Found

The requested resource could not be found.

429 Too Many Requests

This error message indicates that you have hit your assigned rate limit for the API.

5xx Server Error Codes

These errors occur when the server fails to fulfill an apparently valid request.

500 Internal Server Error

A generic error message, given when an unexpected condition was encountered and no more specific message is suitable.

Handling Errors

When you encounter these error codes, your application should handle them appropriately. For client errors (4xx), check the request format and data. For server errors (5xx), you may need to retry the request after some time or contact our support team for assistance.