# too-many-requests

<Badge variant="warning">429 Too Many Requests</Badge> <Badge variant="muted">too-many-requests</Badge>

| Field           | Value                                              |
|-----------------|----------------------------------------------------|
| **Type URI**    | `https://docs.kordiam.app/docs/errors/too-many-requests` |
| **HTTP Status** | `429 Too Many Requests`                            |

## Description
The client has exceeded an allowed request rate. The server is throttling further requests.

## Response Example
```json
{
  "type": "https://docs.kordiam.app/docs/errors/too-many-requests",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Too many requests",
  "instance": "/api/v2/elements",
  "traceId": "abc-123-def",
  "retryAfter": 60
}
```

## Common Causes
- The request rate for the endpoint has been exceeded.
- The client sent a burst of requests faster than the deployment allows.

## How to Fix

1. Check the `Retry-After` response header or the `retryAfter` response property to determine how long to wait before retrying.
2. Implement exponential backoff with jitter in your client to avoid bursts of requests.
3. Reduce polling frequency or batch requests where the endpoint supports it.
