GET
https://api.tennisdatabaseapi.com/v1/tournaments/{id}Every planA tournament and every season held.
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
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"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/tournaments/tn_1d50xrzv'); 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", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/tournaments/tn_1d50xrzv", { 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": "tn_1d50xrzv",
"name": "US Open",
"event_known": true,
"tour": "men",
"tier": "slam",
"surface": "hard",
"first_season": 1881,
"last_season": 2026,
"seasons": [
{ "season": 2026, "start": "2026-08-24", "end": "2026-09-13", "matches": 239 },
{ "season": 2025, "start": "2025-08-18", "end": "2025-09-07", "matches": 239 },
{ "season": 2024, "start": "2024-08-19", "end": "2024-09-08", "matches": 239 },
"..."
]
},
"meta": {}
}{
"data": {
"id": "tn_1d50xrzv",
"name": "US Open",
"event_known": true,
"tour": "men",
"tier": "slam",
"surface": "hard",
"first_season": 1881,
"last_season": 2026,
"seasons": [
{ "season": 2026, "start": "2026-08-24", "end": "2026-09-13", "matches": 239 },
{ "season": 2025, "start": "2025-08-18", "end": "2025-09-07", "matches": 239 },
{ "season": 2024, "start": "2024-08-19", "end": "2024-09-08", "matches": 239 },
"..."
]
},
"meta": {}
}{
"error": {
"code": "not_found",
"message": "No tournament 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 tournament id, tn_ and 8 characters |
name | The event's name |
event_known | false for the one row a season holding men's ITF matches whose event is not recorded |
tour, tier | men or women; slam, tour, challenger, itf, utr, team, other |
surface | clay, grass, hard, hard_indoor, carpet |
first_season, last_season | The first and latest season held |
seasons | Every season held, newest first: season, start, end, matches |
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). |