GET
https://api.tennisdatabaseapi.com/v1/players/{id}/titlesEvery planEvery final a player won and lost, by level.
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/players/pl_f560sfd7/titles?tier=slam
1Parameters
| Name | What it is |
|---|---|
idrequired | An id from another answer, such as pl_ and 8 characters. Ids are our own and never change. |
tier | The level of the event: slam, tour, challenger, itf, utr, team, other. |
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/players/pl_f560sfd7/titles?tier=slam"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/players/pl_f560sfd7/titles?tier=slam'); 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/players/pl_f560sfd7/titles?tier=slam", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/players/pl_f560sfd7/titles?tier=slam", { 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": {
"player": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
"titles": 2,
"by_level": { "slam": 2 },
"won": [
{
"tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
"season": 2026,
"date": "2026-09-13",
"match": "mt_9e5aq213",
"opponent": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
"score": "6-3 7-6(2) 5-7 6-2"
},
{
"tournament": { "id": "tn_xq6dqwv3", "name": "French Open", "tier": "slam" },
"season": 2026,
"date": "2026-06-07",
"match": "mt_25ebhnjf",
"opponent": { "id": "pl_chv1pb4y", "name": "Cobolli F.", "country": "Italy" },
"score": "6-1 4-6 6-4 6-7(5) 6-1"
}
],
"lost": [
{
"tournament": { "id": "tn_4t7csf87", "name": "Wimbledon", "tier": "slam" },
"season": 2026,
"date": "2026-07-12",
"match": "mt_8re2h4jk",
"opponent": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"score": "6-7(7) 7-6(2) 6-3 6-4"
},
{
"tournament": { "id": "tn_qrrczgdw", "name": "Australian Open", "tier": "slam" },
"season": 2025,
"date": "2025-01-26",
"match": "mt_6p9rcaem",
"opponent": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"score": "6-3 7-6(4) 6-3"
},
{
"tournament": { "id": "tn_xq6dqwv3", "name": "French Open", "tier": "slam" },
"season": 2024,
"date": "2024-06-09",
"match": "mt_grxq228m",
"opponent": { "id": "pl_s0fxc3xg", "name": "Alcaraz C.", "country": "Spain" },
"score": "6-3 2-6 5-7 6-1 6-2"
},
{
"tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
"season": 2020,
"date": "2020-09-13",
"match": "mt_j3qfe337",
"opponent": { "id": "pl_06sxh10y", "name": "Thiem D.", "country": "Austria" },
"score": "2-6 4-6 6-4 6-3 7-6(6)"
}
]
},
"meta": { "finals": 6 }
}{
"data": {
"player": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
"titles": 2,
"by_level": { "slam": 2 },
"won": [
{
"tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
"season": 2026,
"date": "2026-09-13",
"match": "mt_9e5aq213",
"opponent": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
"score": "6-3 7-6(2) 5-7 6-2"
},
{
"tournament": { "id": "tn_xq6dqwv3", "name": "French Open", "tier": "slam" },
"season": 2026,
"date": "2026-06-07",
"match": "mt_25ebhnjf",
"opponent": { "id": "pl_chv1pb4y", "name": "Cobolli F.", "country": "Italy" },
"score": "6-1 4-6 6-4 6-7(5) 6-1"
}
],
"lost": [
{
"tournament": { "id": "tn_4t7csf87", "name": "Wimbledon", "tier": "slam" },
"season": 2026,
"date": "2026-07-12",
"match": "mt_8re2h4jk",
"opponent": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"score": "6-7(7) 7-6(2) 6-3 6-4"
},
{
"tournament": { "id": "tn_qrrczgdw", "name": "Australian Open", "tier": "slam" },
"season": 2025,
"date": "2025-01-26",
"match": "mt_6p9rcaem",
"opponent": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
"score": "6-3 7-6(4) 6-3"
},
{
"tournament": { "id": "tn_xq6dqwv3", "name": "French Open", "tier": "slam" },
"season": 2024,
"date": "2024-06-09",
"match": "mt_grxq228m",
"opponent": { "id": "pl_s0fxc3xg", "name": "Alcaraz C.", "country": "Spain" },
"score": "6-3 2-6 5-7 6-1 6-2"
},
{
"tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
"season": 2020,
"date": "2020-09-13",
"match": "mt_j3qfe337",
"opponent": { "id": "pl_06sxh10y", "name": "Thiem D.", "country": "Austria" },
"score": "2-6 4-6 6-4 6-3 7-6(6)"
}
]
},
"meta": { "finals": 6 }
}{
"error": {
"code": "not_found",
"message": "No player with this id.",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}Real answers from the API, made 2026-11-18. Long lists are cut to three items here.
4Fields
| Field | What it holds |
|---|---|
player, titles, by_level | Who, how many titles, and how many at each level |
won, lost | Every final, newest first: tournament, season, date, match, opponent, score |
5Errors
bad_request | A value out of range, such as a date or a tier that is not one of the list. |
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). |