Errors
Understand and handle errors returned by the Tariff8 API.
Standard Format
In case of error, the API always returns a 4xx or 5xx HTTP code and a JSON body structured as follows:
error.json
HTTP Codes
| Code | Type | Description |
|---|---|---|
| 400 | Bad Request | The request is malformed (invalid JSON, missing parameters). |
| 401 | Unauthorized | API key is missing or invalid. |
| 403 | Forbidden | You do not have permissions (e.g. credits exhausted). |
| 404 | Not Found | The requested resource does not exist. |
| 429 | Too Many Requests | You exceeded the request limit (Rate Limit). |
| 500 | Internal Server Error | Server side error. Our teams are notified. |