---
title: Error Codes
description: API error codes and what they mean
url: https://www.supalytics.co/docs/api/errors
---



| Status | Description                                      |
| ------ | ------------------------------------------------ |
| 400    | Invalid request body                             |
| 401    | Missing or invalid API key                       |
| 403    | Insufficient permissions or usage limit exceeded |
| 429    | Rate limit exceeded (100 req/min)                |
| 500    | Server error                                     |

## Error Response Format

```json
{
  "error": "Invalid query",
  "details": {
    "fieldErrors": {
      "metrics": ["Required"]
    }
  }
}
```

## Common Errors

### Usage Limit Exceeded

```json
{
  "error": "Usage limit exceeded",
  "message": "Your team has exceeded the event limit for this billing period. Please upgrade your plan to continue accessing analytics."
}
```

### Rate Limit Exceeded

```json
{
  "error": "Rate limit exceeded. Maximum 100 requests per minute."
}
```


---

## Other Documentation

- [Autocapture](https://www.supalytics.co/llms/docs/autocapture)
- [Backfill Existing Subscriptions](https://www.supalytics.co/llms/docs/backfill-existing-subscriptions)
- [Block Your Own Traffic](https://www.supalytics.co/llms/docs/block-your-traffic)
- [CLI](https://www.supalytics.co/llms/docs/cli)
- [Custom Events](https://www.supalytics.co/llms/docs/custom-events)
- [Features](https://www.supalytics.co/llms/docs/features)
- [Conversion Funnels](https://www.supalytics.co/llms/docs/funnels)
- [Introduction](https://www.supalytics.co/llms/docs)
- [Install Script](https://www.supalytics.co/llms/docs/install-script)
- [MRR Tracking](https://www.supalytics.co/llms/docs/mrr-tracking)
- [Revenue Attribution](https://www.supalytics.co/llms/docs/revenue-attribution)
- [Agent Skills](https://www.supalytics.co/llms/docs/skills)
- [Tracking Modes](https://www.supalytics.co/llms/docs/tracking-modes)
- [Visitor Journey](https://www.supalytics.co/llms/docs/visitor-journey)
- [Annotations](https://www.supalytics.co/llms/docs/api/annotations)
- [Events (Read)](https://www.supalytics.co/llms/docs/api/events)
- [API Reference](https://www.supalytics.co/llms/docs/api)
- [Journeys](https://www.supalytics.co/llms/docs/api/journeys)
- [Query API](https://www.supalytics.co/llms/docs/api/query)
- [Realtime API](https://www.supalytics.co/llms/docs/api/realtime)
- [Revenue Attribution API](https://www.supalytics.co/llms/docs/api/revenue-attribution)
- [Events (Write)](https://www.supalytics.co/llms/docs/api/server-side-events)