tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsPlayersPlayer titles
Players

Player titles

MCP tool player_titles
GEThttps://api.tennisdatabaseapi.com/v1/players/{id}/titlesEvery plan

Every final a player won and lost, by level.

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/players/pl_f560sfd7/titles?tier=slam

1Parameters

NameInTypeWhat it is
idrequiredpathidAn id from another answer, such as pl_ and 8 characters. Ids are our own and never change.
tierquerystringThe level of the event: slam, tour, challenger, itf, utr, team, other.

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/players/pl_f560sfd7/titles?tier=slam"

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": {
    "player": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
    "titles": 2,
    "by_level": { "slam": 2 },
    "won": [
      {
        "tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
        "season": 2026,
        "date": "2026-09-13",
        "match": "mt_9e5aq213",
        "opponent": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
        "score": "6-3 7-6(2) 5-7 6-2"
      },
      {
        "tournament": { "id": "tn_xq6dqwv3", "name": "French Open", "tier": "slam" },
        "season": 2026,
        "date": "2026-06-07",
        "match": "mt_25ebhnjf",
        "opponent": { "id": "pl_chv1pb4y", "name": "Cobolli F.", "country": "Italy" },
        "score": "6-1 4-6 6-4 6-7(5) 6-1"
      }
    ],
    "lost": [
      {
        "tournament": { "id": "tn_4t7csf87", "name": "Wimbledon", "tier": "slam" },
        "season": 2026,
        "date": "2026-07-12",
        "match": "mt_8re2h4jk",
        "opponent": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
        "score": "6-7(7) 7-6(2) 6-3 6-4"
      },
      {
        "tournament": { "id": "tn_qrrczgdw", "name": "Australian Open", "tier": "slam" },
        "season": 2025,
        "date": "2025-01-26",
        "match": "mt_6p9rcaem",
        "opponent": { "id": "pl_vsvgrrag", "name": "Sinner J.", "country": "Italy" },
        "score": "6-3 7-6(4) 6-3"
      },
      {
        "tournament": { "id": "tn_xq6dqwv3", "name": "French Open", "tier": "slam" },
        "season": 2024,
        "date": "2024-06-09",
        "match": "mt_grxq228m",
        "opponent": { "id": "pl_s0fxc3xg", "name": "Alcaraz C.", "country": "Spain" },
        "score": "6-3 2-6 5-7 6-1 6-2"
      },
      {
        "tournament": { "id": "tn_1d50xrzv", "name": "US Open", "tier": "slam" },
        "season": 2020,
        "date": "2020-09-13",
        "match": "mt_j3qfe337",
        "opponent": { "id": "pl_06sxh10y", "name": "Thiem D.", "country": "Austria" },
        "score": "2-6 4-6 6-4 6-3 7-6(6)"
      }
    ]
  },
  "meta": { "finals": 6 }
}

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

4Fields

FieldTypeWhat it holds
player, titles, by_levelmixedWho, how many titles, and how many at each level
won, lostarrayEvery final, newest first: tournament, season, date, match, opponent, score

5Errors

400bad_requestA value out of range, such as a date or a tier that is not one of the list.
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).