Documentation / Endpoints

All endpoints

Every endpoint, grouped by what it returns. The ones marked PLANNED are not built yet: each says what it needs and which plans will get it.

41endpoints in the plan

15built and callable now

26planned, to be built

Plans: Free key, Live, Archive, Complete included not included

Matches5 available, 5 planned
`GET /v1/matches`	Matches on a day or across dates, every event.
`GET /v1/matches/{id}`	One match: players, score, every game, length, table, format, real start, timeouts and cards.
`GET /v1/matches/{id}/points`	Point by point: every score in every game as our live tracking saw it, about every 10 seconds, with who served. For matches followed live from October 2026.
`GET /v1/live`	Matches being played now, with the game in progress. Refreshed about every 10 seconds.
`GET /v1/results/yesterday`	Yesterday's finished matches, every event. On every plan.
`GET /v1/matches/{id}/points`	Point by point: server, winner and running score of every point	PLANNEDNeeds: Point-by-point collector For: Live, Archive, Complete
`GET /v1/matches/{id}/stats`	Match stats: serve and return points won, longest run, points at 10-all	PLANNEDNeeds: Point by point first For: Live, Archive, Complete
`GET /v1/matches/{id}/rubbers`	Team ties: each individual match inside the tie	PLANNEDNeeds: Team rubber parsing from the tie cards For: All plans
`GET /v1/matches/changes`	Everything that changed since a time you give, for keeping a copy in sync	PLANNEDNeeds: Change log on matches (data we hold) For: Live, Archive, Complete
`WSS /v1/stream`	Live changes pushed over a WebSocket as they happen, no polling	PLANNEDNeeds: Push service on the API host For: Live, Complete
Events3 available, 4 planned
`GET /v1/events`	Events: past, running and scheduled, newest first.
`GET /v1/events/{id}`	One event: name, dates, venue, and its disciplines with match counts.
`GET /v1/events/{id}/matches`	An event's matches, in order of play.
`GET /v1/events/{id}/draw`	The draw as a bracket for one discipline, round by round	PLANNEDNeeds: Bracket builder from rounds (data we hold) For: All plans
`GET /v1/events/{id}/results`	Winners, finalists and semi-finalists of every discipline	PLANNEDNeeds: Data we hold For: All plans
`GET /v1/events/{id}/players`	Everyone entered in the event, by discipline	PLANNEDNeeds: Data we hold For: All plans
`GET /v1/events/{id}/stats`	Event totals: matches, deciding games, longest match, biggest comebacks	PLANNEDNeeds: Data we hold For: Live, Archive, Complete
Players4 available, 7 planned
`GET /v1/players`	Find players by name or country.
`GET /v1/players/{id}`	One player: name, country and their record by discipline.
`GET /v1/players/{id}/matches`	A player's matches, newest first, singles and doubles.
`GET /v1/h2h/{a}/{b}`	Two players against each other: wins, games, and every meeting.
`GET /v1/players/{id}/stats`	Career stats: win rate by discipline, games won, deciding games, average length	PLANNEDNeeds: Data we hold For: Live, Archive, Complete
`GET /v1/players/{id}/form`	Recent form: last results, current streak, events played	PLANNEDNeeds: Data we hold For: All plans
`GET /v1/players/{id}/opponents`	Record against every opponent faced	PLANNEDNeeds: Data we hold For: Archive, Complete
`GET /v1/players/{id}/events`	Events played, with the best round reached in each	PLANNEDNeeds: Data we hold For: All plans
`GET /v1/players/{id}/partners`	Doubles partners and the record with each	PLANNEDNeeds: Data we hold For: Archive, Complete
`GET /v1/players/{id}/titles`	Titles and finals, by event and discipline	PLANNEDNeeds: Data we hold For: All plans
`GET /v1/players/compare`	Two to four players side by side on the same stats	PLANNEDNeeds: Player stats first For: Live, Archive, Complete
Rankings2 available, 0 planned
`GET /v1/rankings`	World rankings: the top 100 of a list for a week, with points and movement. The latest week unless you ask for one.
`GET /v1/players/{id}/rankings`	A player's world ranking week by week, on every list they are in, newest first.
Statistics0 available, 5 planned
`GET /v1/stats/leaders`	Leaders over a period: wins, win rate, titles, by discipline	PLANNEDNeeds: Data we hold For: Live, Archive, Complete
`GET /v1/stats/longest-matches`	The longest matches by time, with every game	PLANNEDNeeds: Data we hold For: Archive, Complete
`GET /v1/stats/deciding-games`	Best and worst records in deciding games	PLANNEDNeeds: Data we hold For: Archive, Complete
`GET /v1/stats/serve`	Serve and return leaders: points won on serve and on return	PLANNEDNeeds: Point by point first For: Archive, Complete
`GET /v1/stats/countries`	Countries ranked by wins, titles and players, by discipline	PLANNEDNeeds: Data we hold For: All plans
Reference and account1 available, 5 planned
`GET /v1/usage`	Your plan, calls today, limits and the dates your plan reads. Not counted against your allowance.
`GET /v1/reference`	Every code the API uses: disciplines, age groups, para classes, rounds, tiers	PLANNEDNeeds: Data we hold For: All plans, no call counted
`GET /v1/status`	Data freshness: when live, results and events last updated. No key needed	PLANNEDNeeds: Job log (data we hold) For: Public
`GET /v1/keys`	List, label and revoke your keys from code	PLANNEDNeeds: Account area For: All plans
`GET /v1/webhooks`	Manage your webhook addresses from code. Webhooks themselves work today, set up from the dashboard	PLANNEDNeeds: An API for webhook addresses For: Live, Complete
`POST /v1/batch`	Up to 20 calls in one request, answered together	PLANNEDNeeds: Batch runner on the API host For: Live, Archive, Complete