# rate_limited (HTTP 429)

Fix: wait the Retry-After seconds, then pace calls with the RateLimit headers. rate_limited (HTTP 429) is a short burst throttle, not your plan quota.

- **HTTP status:** 429
- **Problem type URI:** https://nowgetitdone.com/docs/api/problems/rate-limited

## What it means

The per-credential burst window was exceeded. This is a short-term throttle, not your billing-period allowance.

## Likely causes

- Requests arrived faster than the plan’s per-minute burst allowance.

## How to fix

- Back off and retry after the `Retry-After` header’s number of seconds.
- Read the `RateLimit` / `X-RateLimit-*` headers to pace requests before you hit the wall.
- Spread bulk work over time, or upgrade for a higher burst allowance.

## Example problem+json

```json
{
    "type": "https://nowgetitdone.com/docs/api/problems/rate-limited",
    "title": "Rate limit exceeded",
    "status": 429,
    "code": "rate_limited",
    "request_id": "req_a1b2c3d4"
}
```

## Related

- [Rate limits & quotas](/docs/api#rate-limits)