# Limits (/docs/limits)



The library is free. API rate limits protect availability; a key is optional.

| Tier            | Per minute | Extra bound                                       |
| --------------- | ---------- | ------------------------------------------------- |
| Keyless         | 20         | IP only                                           |
| Anonymous       | 60         | 500 lifetime requests and 7-day expiry            |
| Claimed         | 300        | 5,000 requests per day                            |
| Legacy upgraded | 600        | 50,000 requests per day; historical accounts only |

When a limit is hit:

* `429` + `Retry-After` for per-minute throttles
* `403 key_expired` or `403 quota_exhausted` for anonymous lifetime limits, with `hint: /api/v1/auth/claim`

`GET /api/v1/usage` (Bearer required) returns the current tier and remaining-facing counters.