> For the complete documentation index, see [llms.txt](https://p00ls.gitbook.io/token-os/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://p00ls.gitbook.io/token-os/overview/errors.md).

# Errors

P00LS uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the `2xx` range indicate success. Codes in the `4xx` range indicate an error that failed given the information provided (e.g., a required parameter was omitted, etc.). Codes in the `5xx` range indicate an error with P00LS's servers.

<table><thead><tr><th width="332">HTTP Status Code Summary</th><th></th></tr></thead><tbody><tr><td><strong>200</strong> - OK</td><td>Everything worked as expected.</td></tr><tr><td><strong>400</strong> - Bad Request</td><td>The request was unacceptable, often due to a missing required parameter.</td></tr><tr><td><strong>401</strong> - Unauthorized</td><td>No valid API key provided.</td></tr><tr><td><strong>402</strong> - Request Failed</td><td>The parameters were valid but the request failed.</td></tr><tr><td><strong>403</strong> - Forbidden</td><td>The API key doesn't have permissions to perform the request.</td></tr><tr><td><strong>404</strong> - Not Found</td><td>The requested resource doesn't exist.</td></tr><tr><td><strong>409</strong> - Conflict</td><td>The request conflicts with another request.</td></tr><tr><td><strong>429</strong> - Too Many Requests</td><td>Too many requests hit the API too quickly.  We recommend an exponential backoff of your requests.</td></tr><tr><td><strong>500, 502, 503, 504</strong> - Server Errors</td><td>Something went wrong on P00LS's end.</td></tr></tbody></table>