tennisdatabaseAPI

Tennis API documentation

Ctrl K
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/tournamentsTournaments, 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}/drawOne season of a tournament round by round, from qualifying to the final, with seeds and entry
GETChampions/v1/tournaments/{id}/championsThe champion and runner-up of every season of a tournament, and who has won it most

2Common jobs

Find an eventGET /v1/tournaments?search=open&tier=slam
Every season heldGET /v1/tournaments/{id}
Every match of one seasonGET /v1/tournaments/{id}/2025
The draw of one seasonGET /v1/tournaments/{id}/2025/draw
Every championGET /v1/tournaments/{id}/champions