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

# API rate limits

> Omnichar API rate limits per API key and per client address, which endpoints have their own budget, and how to back off when you receive a 429.

| Requests | Limit |
| - | - |
| Calls with a key | 120 a minute per key |
| `POST /v1/licenses` | 60 a minute per key |
| `GET /v1/licenses/{key}/verify` | 60 a minute per client address |
| `GET /v1/openapi.json` | 30 a minute per client address |
| Webhook test sends | 10 a minute per team |

Over the limit you get `429` with the code `rate_limited`. The `retry-after` header says how many seconds to wait, and `x-ratelimit-remaining` shows what is left in the current minute.

Back off before retrying, and prefer [webhooks](https://docs.omnichar.org/api/webhooks.md) to polling a character's status in a tight loop.


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