CreatorDB communicates request status through HTTP response codes. A response in the 2xx range means the request was successful, while a 4xx response suggests an error caused by invalid credentials, insufficient API credits, or missing parameters. A response in the 5xx range indicates an error on the server side, which may be temporary. If you encounter a 5xx error, please try your request again later. If the issue persists, contact CreatorDB support for assistance.
Error types and HTTP status codes
The following table shows the different error types based on the status code of the HTTP response:
| HTTP STATUS CODE | ERROR TYPE | DESCRIPTION |
|---|
| 400 | VALIDATION ERROR | This request is invalid or a validation error occurred. Check the details field in the response for more information about the specific errors. |
| 401 | UNAUTHORIZED | This request is unauthorized. This error occurs when the API key is missing or invalid. Please check the API key in the request header and make sure it is correct. |
| 403 | FORBIDDEN | This request is authenticated but the user does not have permission to access the requested resource. Check your API key permissions and ensure you are authorized to access the requested data. |
| 404 | NOT FOUND | The requested resource could not be found. This error occurs when the specified endpoint or resource does not exist. Verify the endpoint URL and parameters in your request. |
| 409 | CONFLICT | This request could not be completed due to a conflict with the current state of the resource. This error may occur when there are duplicate entries or conflicting data in the request. Check the request data for any conflicts and try again. |
| 429 | QUOTA EXCEEDED | The request rate limit or quota has been exceeded. This error occurs when you have made too many requests in a short period of time. Please wait and try again later. |
| 500 | INTERNAL SERVER ERROR | An unexpected error occurred on the server. This error may occur due to temporary issues or maintenance. Please try again later. If the issue persists, contact CreatorDB support for assistance. |
| 503 | SERVICE UNAVAILABLE | The server is currently unavailable. This error may occur due to temporary database or upstream service issues or maintenance. Please try again later. If the issue persists, contact CreatorDB support for assistance. |
Last modified on February 9, 2026
