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

# Rate limits

> The myAbode Deals API allows 120 requests per minute per API key. How to read the rate-limit headers and handle a 429 response.

Each API key can make **120 requests per minute**. Every response tells you where you stand:

| Header | Meaning |
| - | - |
| `X-RateLimit-Limit` | Requests allowed per minute (120) |
| `X-RateLimit-Remaining` | Requests left in the current minute |
| `X-RateLimit-Reset` | Seconds until the budget resets |

Over the limit, the API returns `429 RATE_LIMITED` with a `Retry-After` header giving the seconds to wait.

## Staying under the limit

* **Page with `limit=100`** to fetch more per request.
* **Sync incrementally.** Use [`updated_since`](https://docs.myabode.ca/api/pagination#incremental-sync-with-updated_since) or the [event feed](https://docs.myabode.ca/api/events.md) instead of re-reading everything.
* **Fetch many deals at once** with `id` (up to 100 IDs per request) instead of one request per deal.
* **On `429`, wait** for `Retry-After` seconds before retrying, and back off if it happens again.

Requests that fail authentication are limited per IP address.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.