API Error Codes

400Bad Request

The request was invalid or could not be understood. The response body will include a specific error field describing what went wrong (e.g., missing required parameters, invalid parameter values, or malformed input). Check the error message in the response for details and correct your request accordingly.

Some common error messages include:

Missing API Key. If your request is missing the required API key, you will receive an error message indicating "Missing API Key." Please ensure that you include your API key in the X-Api-Key header or as a parameter.

Invalid API Key. If your API key is not recognized or is invalid, you will receive an error message indicating "Invalid API Key." Double-check your API key and make sure it is correct and active.

This endpoint is for premium subscribers only. You are trying to access an endpoint that is available only to premium subscribers. Please upgrade to a premium subscription to access this endpoint.

403Forbidden

The server understood the request but refuses to authorize it. The most likely cause is that you made a request to an API version that is no longer supported or you have made a typo in the API endpoint URL.

404Not Found

The requested resource could not be found. The most likely cause is that the endpoint you are trying to access does not exist or you have made a typo in the API endpoint URL.

429Too Many Requests

You have exceeded the rate limit for your API key. Free users are rate limited due to the availability of free tier servers. Please wait before making further requests or upgrade to a premium subscription.

500Internal Server Error

An unexpected error occurred on our servers. Please retry your request later. If the problem persists, please contact our support team.