tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsRecordsAll-time leaders
Records

All-time leaders

MCP tool all_time_leaders
GEThttps://api.tennisdatabaseapi.com/v1/recordsEvery plan

The most matches won and the most titles, all time.

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/records?tour=women

1Parameters

NameInTypeWhat it is
tourquerystringMen or women: men, women.

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/records?tour=women"

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": {
    "tour": "women",
    "players": 37659,
    "most_wins": [
      {
        "player": { "id": "pl_v6chwrgc", "name": "Williams S.", "country": "USA" },
        "won": 893,
        "lost": 159
      },
      {
        "player": { "id": "pl_0w81zps0", "name": "Williams V.", "country": "USA" },
        "won": 844,
        "lost": 312
      },
      {
        "player": { "id": "pl_e2xeza1n", "name": "Maria T.", "country": "Germany" },
        "won": 834,
        "lost": 629
      },
      "..."
    ],
    "most_titles": [
      {
        "player": { "id": "pl_w2qkm1dy", "name": "Graf S.", "country": "Germany" },
        "titles": 88,
        "grand_slams": 20
      },
      {
        "player": { "id": "pl_v6chwrgc", "name": "Williams S.", "country": "USA" },
        "titles": 72,
        "grand_slams": 23
      },
      {
        "player": { "id": "pl_4d24bdxd", "name": "Seles M.", "country": "USA" },
        "titles": 52,
        "grand_slams": 9
      },
      "..."
    ]
  },
  "meta": {
    "counted_at": "2026-11-18 03:54:34",
    "note": "Wins count every level held, walkovers left out; titles count Grand Slam and tour-level champions."
  }
}

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

4Fields

FieldTypeWhat it holds
most_winsarrayplayer, won, lost: every level held
most_titlesarrayplayer, titles, grand_slams

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.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).