GET
https://api.tennisdatabaseapi.com/v1/recordsEvery planThe most matches won and the most titles, all time.
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/records?tour=women
1Parameters
| Name | What it is |
|---|---|
tour | Men or women: men, women. |
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/records?tour=women"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/records?tour=women'); 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/records?tour=women", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/records?tour=women", { 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": {
"tour": "women",
"players": 37659,
"most_wins": [
{
"player": { "id": "pl_v6chwrgc", "name": "Williams S.", "country": "USA" },
"won": 893,
"lost": 159
},
{
"player": { "id": "pl_0w81zps0", "name": "Williams V.", "country": "USA" },
"won": 844,
"lost": 312
},
{
"player": { "id": "pl_e2xeza1n", "name": "Maria T.", "country": "Germany" },
"won": 834,
"lost": 629
},
"..."
],
"most_titles": [
{
"player": { "id": "pl_w2qkm1dy", "name": "Graf S.", "country": "Germany" },
"titles": 88,
"grand_slams": 20
},
{
"player": { "id": "pl_v6chwrgc", "name": "Williams S.", "country": "USA" },
"titles": 72,
"grand_slams": 23
},
{
"player": { "id": "pl_4d24bdxd", "name": "Seles M.", "country": "USA" },
"titles": 52,
"grand_slams": 9
},
"..."
]
},
"meta": {
"counted_at": "2026-11-18 03:54:34",
"note": "Wins count every level held, walkovers left out; titles count Grand Slam and tour-level champions."
}
}{
"data": {
"tour": "women",
"players": 37659,
"most_wins": [
{
"player": { "id": "pl_v6chwrgc", "name": "Williams S.", "country": "USA" },
"won": 893,
"lost": 159
},
{
"player": { "id": "pl_0w81zps0", "name": "Williams V.", "country": "USA" },
"won": 844,
"lost": 312
},
{
"player": { "id": "pl_e2xeza1n", "name": "Maria T.", "country": "Germany" },
"won": 834,
"lost": 629
},
"..."
],
"most_titles": [
{
"player": { "id": "pl_w2qkm1dy", "name": "Graf S.", "country": "Germany" },
"titles": 88,
"grand_slams": 20
},
{
"player": { "id": "pl_v6chwrgc", "name": "Williams S.", "country": "USA" },
"titles": 72,
"grand_slams": 23
},
{
"player": { "id": "pl_4d24bdxd", "name": "Seles M.", "country": "USA" },
"titles": 52,
"grand_slams": 9
},
"..."
]
},
"meta": {
"counted_at": "2026-11-18 03:54:34",
"note": "Wins count every level held, walkovers left out; titles count Grand Slam and tour-level champions."
}
}{
"error": {
"code": "bad_request",
"message": "tour is one of: men, women.",
"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 |
|---|---|
most_wins | player, won, lost: every level held |
most_titles | player, titles, grand_slams |
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. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |