Documentation/Free key overview
Free key overview
FreeA free key is a real key on the real archive, not a demo. It covers yesterday, today and the fixtures ahead, with 50 lookups a day, which is enough to build and test an app end to end.
What it covers
Results since yesterday, today's matches, every fixture ahead, current tables, teams and search.
What it leaves out
Older seasons, lineups, timelines, player profiles, stats and the today-by-time-zone endpoint.
When you outgrow it
Archive opens every season we hold for $49 a month. Live adds today and webhooks for $99. Compare plans
The 11 endpoints on a free key
| Endpoint | What it gives you |
|---|---|
/v1/matches | Every match in a date range, filtered by competition, team or status. Paged, newest first. Free key: from yesterday onwards. An earlier date_from returns 403 with the upgrade link. |
/v1/matches/{id} | One match in full: competition, season, round, venue, scores, half time and the quality flags. Add lineups and the timeline with include. Free key: matches from yesterday onwards, without include. |
/v1/fixtures | Matches still to be played in the next days, nearest first. Kickoff times appear as soon as they are set. |
/v1/results | Finished matches since a date, newest first, with the final score. Results land within two hours of full time. Free key: since yesterday. An earlier since returns 403 with the upgrade link. |
/v1/competitions | Every competition with matches or a table in the archive, with its region, type and how many seasons are on record. |
/v1/seasons/{id}/standings | The table for a season: played, won, drawn, lost, points for and against, difference, bonus points and total. Free key: the current season of each competition. |
/v1/teams/{id} | A team's name, tag, country and type, the competitions it has played in over the last year, and its squad size. |
/v1/rankings | Ratings and ranks of the men's national sides, worked out by us from every Test since 1871 with World Rugby's published points-exchange method. Our own figures, not World Rugby's rankings. Free key: the table now, and as it stood on any date from yesterday. |
/v1/search | Find a competition, team or player by name and get its ID. |
/v1/usage | Your plan, lookups used today and what is left. Free to call; it does not count. |
/v1/status | How fresh the archive is, with the same results rule as the status page: quiet days are not late. Needs no key. |
Every competition works on a free key for yesterday, today and the fixtures ahead. How deep each competition goes