Speed limits and Errors
Speed limits
Every plan's requests-per-second limit and monthly request allowance:
| Plan | Requests / second | Requests / month |
|---|---|---|
| Free | 2 | 1,000 |
| Starter | 5 | 20,000 |
| Growth | 10 | 100,000 |
| Scale | 20 | 500,000 |
| Business | 30 | 5,000,000 |
Headers
Every response, including error responses, carries these:
| Header | Meaning |
|---|---|
X-RateLimit-Limit | This plan's speed limit, in requests per second. |
X-RateLimit-Remaining | Requests left in the current one-second window. |
X-RateLimit-Reset | Seconds until the speed-limit window resets. |
Retry-After | Seconds to wait before retrying (429 SPEED_LIMIT only). |
x-requests-used | Requests used this billing period. |
x-requests-remaining | Requests remaining this billing period. |
x-requests-last | What this one call cost against the allowance (0 for a free call). |
X-Request-Id | This request's id, for support and for matching against `error.request_id`. |
Error codes
Every error is a normal HTTP status with a JSON body: { error: { code, message, docs_url, request_id } }. A 403 naming a required_plan also names your key's current_plan.
ALLOWANCE_SPENT
- The month's allowance is used up:
Monthly allowance of 100000 requests used. Resets 2026-10-01.
BAD_REQUEST
commenceTimeFrom is not a valid ISO-8601 timestamp.
INTERNAL_ERROR
Something went wrong on our side. It has been logged.
INVALID_KEY
- Key does not exist or was revoked:
API key is not valid.
INVALID_MARKET
Invalid markets: not_a_market
INVALID_SESSION
- Session is expired or invalid (account endpoints only):
Your session has expired. Sign in again.
KEY_NOT_FOUND
No API key with that id on this account.
MISSING_KEY
- No X-API-Key header sent:
X-API-Key header is missing.
MISSING_SESSION
- No Authorization: Bearer header sent (account endpoints only):
Sign in and try again.
PLAN_REQUIRED
Props require the Growth plan or above.- History is not on this plan:
History requires the Scale plan or above. - This fixture is older than the plan's 14-day window:
The Scale plan covers fixtures from the last 14 days. This one started 2026-09-02; the Business plan covers everything recorded.
SPEED_LIMIT
- Too many requests this second (Retry-After is set):
Speed limit exceeded: 10 requests/second on the Growth plan. Speed limit exceeded: 10 requests/second on the Growth plan.
UNKNOWN_EVENT
- No fixture with this id under this sport key:
Unknown fixture id for americanfootball_nfl: nfl:falcons-panthers:2026-09-27
UNKNOWN_SPORT
Unknown sport key: basketbal_nba- Sport key does not exist:
Unknown sport key: basketbal_nba