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

# Error Handling

## Error Handling

The API uses standard HTTP status codes.

| HTTP status | Description                        |
| ----------- | ---------------------------------- |
| `400`       | Invalid input or malformed request |
| `401`       | Invalid or missing authentication  |
| `404`       | Resource not found                 |
| `409`       | Resource conflict                  |
| `429`       | Too many requests                  |
| `503`       | Service unavailable                |

### Basic error example

```json
{
  "success": false,
  "timestamp": "2026-01-23T23:33:55.685Z",
  "path": "/api/v1/payments",
  "method": "POST",
  "error": "Unauthorized",
  "message": "Unauthorized"
}
```
