get_player_matches
Read-only
Use for a player's matches, newest first: tournament, surface, round, opponent, result, score by set and the player's rating before and after. Filter by season, surface, opponent_id, tournament_id or draw. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 5 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draw | No | ||
| limit | No | Max matches (default 50). | |
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| offset | No | ||
| season | No | Year. | |
| surface | No | ||
| player_id | Yes | Player id from search_players. | |
| opponent_id | No | Only matches against this player. | |
| tournament_id | No | Only this tournament edition, e.g. "188-2025". |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| tour | Yes | ||
| count | Yes | ||
| matches | Yes | ||
| player_id | Yes | ||
| next_offset | No |