> For the complete documentation index, see [llms.txt](https://developer.providusbank.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.providusbank.com/reference/api-reference/error-handling.md).

# Error Handling

Our API communicates errors through standard HTTP status codes and provides detailed error messages in the response body. Here are common HTTP status codes and their meanings:

### Common HTTP Status Codes

* **200 OK:** The request was successful.
* **400 Bad Request:** The request was malformed or invalid.
* **401 Unauthorized:** Authentication failed or missing credentials.
* **404 Not Found:** The requested resource was not found.
* **429 Too Many Requests:** Exceeded rate limits.

### Handling Errors

When an error occurs, the API response includes a JSON object with an `error` field containing the error message. Example:

```json
{
  "error": "Invalid API key. Please provide a valid key."
}
```