DocsSubjects
Tournaments
Find an event, see every season it has been held, every match and the draw of a season, and its champions.
A tournament is the event across the years; a season is one year of it. Each match sits in a season, which carries the surface it was played on. Some older men's ITF matches are held under one row a season with event_known false.
1Endpoints
GETFind tournaments/v1/tournaments | Tournaments, by name, tour or tier |
GETTournament/v1/tournaments/{id} | A tournament and every season held |
GETTournament season/v1/tournaments/{id}/{season} | Every match of one season of a tournament |
GETSeason draw/v1/tournaments/{id}/{season}/draw | One season of a tournament round by round, from qualifying to the final, with seeds and entry |
GETChampions/v1/tournaments/{id}/champions | The champion and runner-up of every season of a tournament, and who has won it most |
2Common jobs
| Find an event | GET /v1/tournaments?search=open&tier=slam |
| Every season held | GET /v1/tournaments/{id} |
| Every match of one season | GET /v1/tournaments/{id}/2025 |
| The draw of one season | GET /v1/tournaments/{id}/2025/draw |
| Every champion | GET /v1/tournaments/{id}/champions |