tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsTournamentsChampions
Tournaments

Champions

MCP tool tournament_champions
GEThttps://api.tennisdatabaseapi.com/v1/tournaments/{id}/championsEvery plan

The champion and runner-up of every season of a tournament, and who has won it most.

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/champions

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/champions"

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": {
    "tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
    "champions": [
      {
        "season": 2026,
        "date": "2026-09-13",
        "match": "mt_9e5aq213",
        "champion": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
        "runner_up": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
        "score": "6-3 7-6(2) 5-7 6-2"
      },
      {
        "season": 2025,
        "date": "2025-09-07",
        "match": "mt_qbktcd7n",
        "champion": { "id": "pl_s0fxc3xg", "name": "Alcaraz C.", "country": "Spain" },
        "runner_up": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
        "score": "6-2 3-6 6-1 6-4"
      },
      {
        "season": 2024,
        "date": "2024-09-08",
        "match": "mt_jj05p2k3",
        "champion": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
        "runner_up": { "id": "pl_wreyy3j4", "name": "Fritz T.", "country": "USA" },
        "score": "6-3 6-4 7-5"
      },
      "..."
    ],
    "most_titles": [
      {
        "player": { "id": "pl_zk1tqy2m", "name": "Tilden B.", "country": "USA" },
        "titles": 7
      },
      {
        "player": { "id": "pl_c22mkc54", "name": "Larned W.", "country": "USA" },
        "titles": 7
      },
      {
        "player": { "id": "pl_j0sw2rv1", "name": "Sears R.", "country": "USA" },
        "titles": 7
      },
      {
        "player": { "id": "pl_z5vm51dn", "name": "Federer R.", "country": "Switzerland" },
        "titles": 5
      },
      {
        "player": { "id": "pl_06g72esy", "name": "Sampras P.", "country": "USA" },
        "titles": 5
      }
    ]
  },
  "meta": { "count": 146 }
}

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

4Fields

FieldTypeWhat it holds
championsarrayNewest first: season, date, match, champion, runner_up, score
most_titlesarrayThe players who have won it most

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).