Errors
The PredictHQ API uses conventional HTTP status codes to indicate the success or failure of an API request. If you receive an error, this is what it means:
Status Code | Description |
---|---|
Bad Request 400 |
The request contains invalid parameters, or invalid or incomplete data. |
Unauthorized 401 |
You failed to provide an Authorization header, or your credentials are invalid or expired. |
Payment Required 402 |
Your subscription has expired. |
Forbidden 403 |
You tried to perform an action that is not authorized. E.g. you failed to request the required scope. |
Not Found 404 |
The resource or endpoint does not exist. |
Too Many Requests 429 |
You reached your global or subscription rate limit. |
Service Unavailable 503 |
The API has been switched to maintenance mode for a major or complex release. |
If you get a 404 Not Found
, please check that your URL ends with a trailing slash (/
).
As with any API exposed over the public Internet, some requests may fail and they should simply be retried automatically. We recommend that you implement a solution that automatically retries any 5xx
errors 3 times with an exponentially increasing delay.
For example: On receiving a 5xx
response immediately retry, if you receive a subsequent 5xx
response wait 1 second and retry, if you receive a further 5xx
response wait 5 seconds and retry, if you still receive a 5xx response fail the request and handle it accordingly.