GET
https://api.tennisdatabaseapi.com/v1/players/{id}Every planA player, with their win and loss record by surface.
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
1Parameters
| Name | What it is |
|---|---|
idrequired | An id from another answer, such as pl_ 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/players/pl_f560sfd7"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/players/pl_f560sfd7'); 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", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/players/pl_f560sfd7", { 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": {
"id": "pl_f560sfd7",
"name": "Zverev A.",
"full_name": "Zverev Alexander",
"country": "Germany",
"tour": "men",
"born": "1997-04-20",
"height_cm": 198,
"weight_kg": 90,
"plays": "right",
"birthplace": null,
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 2, "highest": 2, "as_of": "2026-10-31" },
"first_match": "2011-08-05",
"last_match": "2026-11-17",
"record": {
"all": { "won": 687, "lost": 315 },
"by_surface": {
"unknown": { "won": 13, "lost": 5 },
"clay": { "won": 234, "lost": 100 },
"grass": { "won": 58, "lost": 26 },
"hard": { "won": 291, "lost": 139 },
"hard_indoor": { "won": 91, "lost": 45 }
}
}
},
"meta": {}
}{
"data": {
"id": "pl_f560sfd7",
"name": "Zverev A.",
"full_name": "Zverev Alexander",
"country": "Germany",
"tour": "men",
"born": "1997-04-20",
"height_cm": 198,
"weight_kg": 90,
"plays": "right",
"birthplace": null,
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 2, "highest": 2, "as_of": "2026-10-31" },
"first_match": "2011-08-05",
"last_match": "2026-11-17",
"record": {
"all": { "won": 687, "lost": 315 },
"by_surface": {
"unknown": { "won": 13, "lost": 5 },
"clay": { "won": 234, "lost": 100 },
"grass": { "won": 58, "lost": 26 },
"hard": { "won": 291, "lost": 139 },
"hard_indoor": { "won": 91, "lost": 45 }
}
}
},
"meta": {}
}{
"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 |
|---|---|
id | The player id, pl_ and 8 characters |
name, full_name | The name as it appears on a draw, and the full name where known |
country | The country the player represents, by name (such as Spain) |
tour | men or women |
born, height_cm, weight_kg, plays | Date of birth, height, weight and playing hand, where known |
birthplace, turned_pro, retired, college | Where they were born, the years they turned professional and retired, and the college they played for, where known |
ranking | current and highest singles ranking, and as_of, the day it was read |
first_match, last_match | The first and the latest match held |
record | all and by_surface, each as won and lost (walkovers left out) |
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). |