DocumentationStart here
Volleyball API plans, rate limits and quota
Plans and limits
Every plan uses the same API. What changes is how many calls you can make, how far back you can read, and whether live scores, rallies and player figures are included.
The plans
| Free key | Live | Archive | Complete | |
|---|---|---|---|---|
| Price | Free | $39 a month | $39 a month | $79 a month |
| Calls a minute | 10 | 60 | 60 | 120 |
| Calls included | 50 a day | 50,000 a month | 50,000 a month | 250,000 a month |
| Days you can read | today and yesterday | last 30 days | since 2001 | since 2001 |
| Live scores | - | Yes | - | Yes |
| Point by point | - | Yes | Yes | Yes |
| Player figures | - | - | Yes | Yes |
Headers on every answer
| Header | What it says |
|---|---|
X-RateLimit-Limit | Calls a minute on your plan |
X-RateLimit-Remaining | Calls left this minute |
X-RateLimit-Reset | Seconds until the minute resets |
X-Quota-Limit | Calls in your day or month |
X-Quota-Remaining | Calls left in it |
X-Quota-Reset | When it resets, UTC |
Retry-After | On a 429: seconds to wait |
Going over
Too many calls in a minute gets a 429 rate_limited with Retry-After; a used-up day or month gets a 429 quota_exceeded with the reset time. Nothing is ever charged for going over. Calls to /v1/usage are never counted, and neither are 429s or answers we fail to give.