API Errors
HTTP status codes
The Path of Exile API returns different HTTP status codes depending on whether or not the request was successful or resulted in some other error.
| Code | Text | Description |
|---|---|---|
| 200 | OK | The request succeeded. |
| 400 | Bad Request | The request was invalid. Check that all arguments are in the correct format. |
| 404 | Not Found | The requested resource was not found. |
| 429 | Too many requests | You are making too many API requests and have been rate limited. |
| 500 | Internal Server Error | We had a problem processing your request. Please try again later or post a bug report. |
Error messages
Error response will contain a JSON object such as the one below. If your application makes decisions based on the error response make sure you use the code rather than the message as the message is subject to change.
{
"error": {
"code": 2,
"message": "Invalid query"
}
}
List of error codes
| Code | Message |
|---|---|
| 1 | Resource not found |
| 2 | Invalid query |
| 3 | Rate limit exceeded |
| 4 | Internal error |
| 5 | Unexpected content type |
| 8 | Unauthorized |
| 6 | Forbidden |
| 7 | Temporarily Unavailable |
