tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsPlayersPlayer profile
Players

Player profile

MCP tool player_profile
GEThttps://api.tennisdatabaseapi.com/v1/players/{id}Every plan

A player, with their win and loss record by surface.

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

1Parameters

NameInTypeWhat it is
idrequiredpathidAn id from another answer, such as pl_ 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/players/pl_f560sfd7"

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": "pl_f560sfd7",
    "name": "Zverev A.",
    "full_name": "Zverev Alexander",
    "country": "Germany",
    "tour": "men",
    "born": "1997-04-20",
    "height_cm": 198,
    "weight_kg": 90,
    "plays": "right",
    "birthplace": null,
    "turned_pro": null,
    "retired": null,
    "college": null,
    "ranking": { "current": 2, "highest": 2, "as_of": "2026-10-31" },
    "first_match": "2011-08-05",
    "last_match": "2026-11-17",
    "record": {
      "all": { "won": 687, "lost": 315 },
      "by_surface": {
        "unknown": { "won": 13, "lost": 5 },
        "clay": { "won": 234, "lost": 100 },
        "grass": { "won": 58, "lost": 26 },
        "hard": { "won": 291, "lost": 139 },
        "hard_indoor": { "won": 91, "lost": 45 }
      }
    }
  },
  "meta": {}
}

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

4Fields

FieldTypeWhat it holds
idstringThe player id, pl_ and 8 characters
name, full_namestringThe name as it appears on a draw, and the full name where known
countrystringThe country the player represents, by name (such as Spain)
tourstringmen or women
born, height_cm, weight_kg, playsmixedDate of birth, height, weight and playing hand, where known
birthplace, turned_pro, retired, collegemixedWhere they were born, the years they turned professional and retired, and the college they played for, where known
rankingobjectcurrent and highest singles ranking, and as_of, the day it was read
first_match, last_matchdateThe first and the latest match held
recordobjectall and by_surface, each as won and lost (walkovers left out)

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