get_head_to_head
Read-only
Use for two players' head to head: wins each, sets won, wins by surface and in finals, and every meeting with its score. Walkovers are listed but not counted as wins; incomplete records are not counted. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| player_id | Yes | First player id. | |
| opponent_id | Yes | Second player id. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tour | Yes | ||
| matches | Yes | ||
| players | Yes | ||
| summary | Yes |