GET
https://api.tennisdatabaseapi.com/v1/tournaments/{id}/championsEvery planThe champion and runner-up of every season of a tournament, and who has won it most.
Free key includedLive includedArchive includedComplete included
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/tournaments/tn_1d50xrzv/champions
1Parameters
| Name | What it is |
|---|---|
idrequired | An id from another answer, such as tn_ and 8 characters. Ids are our own and never change. |
Anything else in the address answers 422 unknown_parameter, with the list of parameters this endpoint takes.
2Request
curl -H "Authorization: Bearer $TDA_KEY" \ "https://api.tennisdatabaseapi.com/v1/tournaments/tn_1d50xrzv/champions"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/tournaments/tn_1d50xrzv/champions'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('TDA_KEY')], CURLOPT_RETURNTRANSFER => true, ]); $answer = json_decode(curl_exec($ch), true); print_r($answer['data']);
import os, requests r = requests.get( "https://api.tennisdatabaseapi.com/v1/tournaments/tn_1d50xrzv/champions", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/tournaments/tn_1d50xrzv/champions", { headers: { Authorization: `Bearer ${process.env.TDA_KEY}` }, }); const { data } = await r.json(); console.log(data);
The code follows the form in Try it, with your key in it once you have entered one. Without a key it reads $TDA_KEY.
3Answer
{
"data": {
"tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
"champions": [
{
"season": 2026,
"date": "2026-09-13",
"match": "mt_9e5aq213",
"champion": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
"runner_up": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
"score": "6-3 7-6(2) 5-7 6-2"
},
{
"season": 2025,
"date": "2025-09-07",
"match": "mt_qbktcd7n",
"champion": { "id": "pl_s0fxc3xg", "name": "Alcaraz C.", "country": "Spain" },
"runner_up": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"score": "6-2 3-6 6-1 6-4"
},
{
"season": 2024,
"date": "2024-09-08",
"match": "mt_jj05p2k3",
"champion": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"runner_up": { "id": "pl_wreyy3j4", "name": "Fritz T.", "country": "USA" },
"score": "6-3 6-4 7-5"
},
"..."
],
"most_titles": [
{
"player": { "id": "pl_zk1tqy2m", "name": "Tilden B.", "country": "USA" },
"titles": 7
},
{
"player": { "id": "pl_c22mkc54", "name": "Larned W.", "country": "USA" },
"titles": 7
},
{
"player": { "id": "pl_j0sw2rv1", "name": "Sears R.", "country": "USA" },
"titles": 7
},
{
"player": { "id": "pl_z5vm51dn", "name": "Federer R.", "country": "Switzerland" },
"titles": 5
},
{
"player": { "id": "pl_06g72esy", "name": "Sampras P.", "country": "USA" },
"titles": 5
}
]
},
"meta": { "count": 146 }
}{
"data": {
"tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
"champions": [
{
"season": 2026,
"date": "2026-09-13",
"match": "mt_9e5aq213",
"champion": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
"runner_up": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
"score": "6-3 7-6(2) 5-7 6-2"
},
{
"season": 2025,
"date": "2025-09-07",
"match": "mt_qbktcd7n",
"champion": { "id": "pl_s0fxc3xg", "name": "Alcaraz C.", "country": "Spain" },
"runner_up": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"score": "6-2 3-6 6-1 6-4"
},
{
"season": 2024,
"date": "2024-09-08",
"match": "mt_jj05p2k3",
"champion": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"runner_up": { "id": "pl_wreyy3j4", "name": "Fritz T.", "country": "USA" },
"score": "6-3 6-4 7-5"
},
"..."
],
"most_titles": [
{
"player": { "id": "pl_zk1tqy2m", "name": "Tilden B.", "country": "USA" },
"titles": 7
},
{
"player": { "id": "pl_c22mkc54", "name": "Larned W.", "country": "USA" },
"titles": 7
},
{
"player": { "id": "pl_j0sw2rv1", "name": "Sears R.", "country": "USA" },
"titles": 7
},
{
"player": { "id": "pl_z5vm51dn", "name": "Federer R.", "country": "Switzerland" },
"titles": 5
},
{
"player": { "id": "pl_06g72esy", "name": "Sampras P.", "country": "USA" },
"titles": 5
}
]
},
"meta": { "count": 146 }
}{
"error": {
"code": "not_found",
"message": "No tournament with this id.",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}Real answers from the API, made 2026-11-20. Long lists are cut to three items here.
4Fields
| Field | What it holds |
|---|---|
champions | Newest first: season, date, match, champion, runner_up, score |
most_titles | The players who have won it most |
5Errors
unauthorized | No key, or a key that is unknown or revoked. |
not_found | No such id. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |