> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate Limits

> API rate limiting details

The Beach Depository API enforces per-key rate limits using a fixed-window strategy.

## Defaults

Each API key is allowed **60 requests per minute** by default. This limit is configurable per key in the dashboard.

## Window

Rate limits use a **fixed 1-minute window**. The window resets at the start of each minute.

## Response headers

Every API response includes rate limit headers:

| Header                  | Description                                     |
| ----------------------- | ----------------------------------------------- |
| `X-RateLimit-Limit`     | Maximum requests allowed in the current window  |
| `X-RateLimit-Remaining` | Requests remaining in the current window        |
| `X-RateLimit-Reset`     | Unix timestamp (seconds) when the window resets |

## Exceeding the limit

When the rate limit is exceeded, the API returns a `429` status code:

```json theme={null}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Try again in 32 seconds."
  }
}
```

The `X-RateLimit-Reset` header indicates when you can resume making requests.