tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsTournamentsTournament
Tournaments

Tournament

MCP tool tournament_seasons
GEThttps://api.tennisdatabaseapi.com/v1/tournaments/{id}Every plan

A 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

NameInTypeWhat it is
idrequiredpathidAn 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"

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": {}
}

Real answers from the API, made 2026-11-18. Long lists are cut to three items here.

4Fields

FieldTypeWhat it holds
idstringThe tournament id, tn_ and 8 characters
namestringThe event's name
event_knownbooleanfalse for the one row a season holding men's ITF matches whose event is not recorded
tour, tierstringmen or women; slam, tour, challenger, itf, utr, team, other
surfacestringclay, grass, hard, hard_indoor, carpet
first_season, last_seasonintegerThe first and latest season held
seasonsarrayEvery season held, newest first: season, start, end, matches

5Errors

401unauthorizedNo key, or a key that is unknown or revoked.
404not_foundNo such id.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).