list_tournaments
Read-only
Use to find tournaments. Lists a season's tournaments in calendar order with dates, city, surface, whether it is a Grand Slam, status, main-draw match count and the champion. Filter by surface (hard, clay, grass, carpet) and status. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 1 credit.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max tournaments (default 100). | |
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| offset | No | Page offset; use next_offset. | |
| season | No | Year, e.g. 2025 (default this year). | |
| status | No | Only upcoming, in-progress or completed tournaments. | |
| surface | No | Only tournaments on this surface. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tour | Yes | ||
| count | Yes | ||
| season | Yes | ||
| next_offset | No | ||
| tournaments | Yes |