Rate Limits
To ensure a reliable experience for all users, the ToHuman API enforces rate limits on requests. If you exceed the limit, requests will return a 429 Too Many Requests response.
Default limits
| Plan | Rate limit | Burst |
|---|---|---|
| Free (unlimited) | 60 requests / minute | 10 |
| Pro | Coming soon | — |
Need higher limits? Contact us to discuss enterprise plans.
Rate limit headers
Every API response includes headers to help you track your rate limit usage:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Maximum number of requests allowed in the current window. |
| X-RateLimit-Remaining | Number of requests remaining in the current window. |
| X-RateLimit-Reset | Unix timestamp when the rate limit window resets. |
When you're rate limited, the response will look like this:
429 Too Many Requests
{
"error": "Rate limit exceeded. Try again later or sign up for an API key."
}
Best practice: implement exponential backoff in your client. Wait a few seconds and retry — the X-RateLimit-Reset header tells you exactly when you can resume.