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

# rate_limit_exceeded

> API rate limit exceeded

|                    |                                 |
| ------------------ | ------------------------------- |
| **HTTP status**    | `429 Too Many Requests`         |
| **Error code**     | `rate_limit_exceeded`           |
| **Resolve action** | `upgrade_plan` (free tier only) |

## What happened

The organization has exceeded the allowed number of API requests per minute. Rate limits are enforced per organization and vary by plan:

| Plan | Limit                  |
| ---- | ---------------------- |
| Free | 1,000 requests/minute  |
| Paid | 10,000 requests/minute |

## Response headers

Responses for API-key-authenticated requests include rate limit headers so clients can track their usage:

| Header                  | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| `X-RateLimit-Limit`     | Maximum requests allowed per minute                     |
| `X-RateLimit-Remaining` | Requests remaining in the current window                |
| `X-RateLimit-Reset`     | Seconds until the rate limit window resets              |
| `Retry-After`           | Seconds to wait before retrying (only on 429 responses) |

## How to fix

Wait for the rate limit window to reset. The `Retry-After` response header indicates how many seconds to wait before retrying. Reduce your request rate or implement exponential backoff to avoid hitting the limit repeatedly.