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

# Rate limits & throttling

> How to handle ButterCMS API rate limits — respect Retry-After headers on 429 responses, use caching to reduce calls, and manage monthly API quotas.

Rate limits are defined in the API reference. This page focuses on practical handling.

## Where to find limits

See [API Rate Limits](../../api/concepts/rate-limits-throttling) for current quotas and headers.

## Recommended handling

* Use caching for high‑traffic endpoints.
* Respect `Retry-After` for `429` responses and wait for the monthly reset if blocked.
* Surface clear errors when monthly quota is exceeded.

## Related guides

<CardGroup cols={2}>
  <Card title="API Performance" icon="gauge-high" href="./api-performance-best-practices" />

  <Card title="Caching Strategies" icon="layer-group" href="./caching-strategies" />
</CardGroup>