GET
https://api.tennisdatabaseapi.com/v1/tournamentsEvery planTournaments, by name, tour or tier.
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?search=us&per_page=2
1Parameters
| Name | What it is |
|---|---|
search | Part of the name. |
tour | Men or women: men, women. |
tier | The level of the event: slam, tour, challenger, itf, utr, team, other. |
page, per_page | Paging: 50 a page unless you ask, at most 50. See Paging. |
cursor | The meta.next_cursor of the page before, to walk a long list. |
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?search=us&per_page=2"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/tournaments?search=us&per_page=2'); 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?search=us&per_page=2", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/tournaments?search=us&per_page=2", { 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_ab0jpcss",
"name": "Australian Open",
"event_known": true,
"tour": "women",
"tier": "slam",
"surface": "hard",
"first_season": 1968,
"last_season": 2026
},
{
"id": "tn_qrrczgdw",
"name": "Australian Open",
"event_known": true,
"tour": "men",
"tier": "slam",
"surface": "hard",
"first_season": 1905,
"last_season": 2026
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"per_page": 2,
"total": 797,
"total_pages": 399,
"next_page": 2,
"prev_page": null
}
}{
"data": [
{
"id": "tn_ab0jpcss",
"name": "Australian Open",
"event_known": true,
"tour": "women",
"tier": "slam",
"surface": "hard",
"first_season": 1968,
"last_season": 2026
},
{
"id": "tn_qrrczgdw",
"name": "Australian Open",
"event_known": true,
"tour": "men",
"tier": "slam",
"surface": "hard",
"first_season": 1905,
"last_season": 2026
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"per_page": 2,
"total": 797,
"total_pages": 399,
"next_page": 2,
"prev_page": null
}
}{
"error": {
"code": "bad_request",
"message": "tier is one of: slam, tour, challenger, itf, utr, team, other.",
"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 |
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). |