get_matches
Read-only
Use for match results by day, tournament or season: each match with both players, seeds, round, status, score and sets (games and tiebreak points). Pass a date (YYYY-MM-DD, UTC), a tournament_id or a season; filter by round (e.g. "Final") and status. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | UTC date, YYYY-MM-DD. | |
| limit | No | Max matches (default 100). | |
| round | No | Round name as listed, e.g. "Final", "Semifinal", "Round 1". | |
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| offset | No | ||
| season | No | Year. | |
| status | No | ||
| tournament_id | No | Tournament edition id, e.g. "188-2025". |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tour | Yes | ||
| count | Yes | ||
| matches | Yes | ||
| next_offset | No |