Core concepts
Per-minute budgets, headers, and 429s.
Every account has a per-minute budget. Free accounts also have a daily budget, counted per IST day. Starter, Growth and Scale have no daily cap. Rate limits are per account. Every key on the account shares them, and creating another key does not reset them.
| Plan | Per minute | Per IST day |
|---|---|---|
| Free | 10 | 100 |
| Starter | 60 | No daily cap |
| Growth | 200 | No daily cap |
| Scale | 500 | No daily cap |
| Enterprise | Agreed | Agreed |
A response on a Free account, two requests into the minute and the day. The counts are the account's, whichever key sent the request:
X-RailCore-RateLimit-Limit: 10
X-RailCore-RateLimit-Remaining: 8
X-RailCore-RateLimit-Reset: 1785472200
X-RailCore-RateLimit-Day-Limit: 100
X-RailCore-RateLimit-Day-Remaining: 98
X-RailCore-RateLimit-Day-Reset: 1785522600X-RailCore-RateLimit-Limit, -Remaining and -Reset are sent only when the account's plan has a per-minute limit. A plan without one (Enterprise), and a request refused before the key was read (a malformed request, a missing or wrong key), get none of the three, never 0. Only Free accounts have a daily cap, and only their keys receive the X-RailCore-RateLimit-Day-* headers. A key without a daily cap gets no Day-* headers and never a daily 429. Read each header only when it is present.
429 means stop
On top of the plan's per-minute budget, and shared by every key on the account like it.
| Route family | Additional cap |
|---|---|
/v1/charts/* | 30 requests per minute per account |
/v1/availability/seats/batch | 30 requests per minute per account |
Rate limits and monthly requests both belong to the account, and its keys share them. A request must pass both. Hitting a rate limit returns 429 and is retryable; running out of requests returns 402 CREDITS_EXHAUSTED and is not retryable until the plan renews or changes. See requests and billing.
Last updated