tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsTournamentsSeason draw
Tournaments

Season draw

MCP tool season_draw
GEThttps://api.tennisdatabaseapi.com/v1/tournaments/{id}/{season}/draw

One season of a tournament round by round, from qualifying to the final, with seeds and entry.

Free key not 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/2026/draw

1Parameters

NameInTypeWhat it is
idrequiredpathidAn id from another answer, such as tn_ and 8 characters. Ids are our own and never change.
seasonrequiredpathyearA season, such as 2024.

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/2026/draw"

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" },
    "season": 2026,
    "draw_size": null,
    "champion": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany", "seed": 1, "entry": null },
    "rounds": [
      {
        "round": "qualifying",
        "matches": [
          {
            "id": "mt_1n1z207c",
            "date": "2026-08-24",
            "next_match": null,
            "winner": { "id": "pl_17zfz9pn", "name": "McDonald M.", "country": "USA", "seed": 28, "entry": null },
            "loser": {
              "id": "pl_37257qjk",
              "name": "Napolitano S.",
              "country": "Italy",
              "seed": null,
              "entry": null
            },
            "score": "6-4 7-5",
            "status": "completed"
          },
          {
            "id": "mt_8n4006dm",
            "date": "2026-08-24",
            "next_match": null,
            "winner": { "id": "pl_bqvc3zy1", "name": "Wong C.", "country": "Hong Kong", "seed": 2, "entry": null },
            "loser": { "id": "pl_sc30yn7d", "name": "Moller E.", "country": "Denmark", "seed": null, "entry": null },
            "score": "5-7 6-3 6-4",
            "status": "completed"
          },
          {
            "id": "mt_fxfpj1cr",
            "date": "2026-08-24",
            "next_match": null,
            "winner": { "id": "pl_xfja74gn", "name": "Gentzsch T.", "country": "Germany", "seed": 29, "entry": null },
            "loser": {
              "id": "pl_6kn13ndx",
              "name": "Martin Tiffon P.",
              "country": "Spain",
              "seed": null,
              "entry": null
            },
            "score": "7-5 6-3",
            "status": "completed"
          },
          "..."
        ]
      },
      {
        "round": "round_1",
        "matches": [
          {
            "id": "mt_e5nfyy85",
            "date": "2026-08-30",
            "next_match": "mt_4dfdzgfs",
            "winner": {
              "id": "pl_88qkmdfj",
              "name": "Etcheverry T.",
              "country": "Argentina",
              "seed": 27,
              "entry": null
            },
            "loser": {
              "id": "pl_r4scfkkp",
              "name": "Kopriva V.",
              "country": "Czech Republic",
              "seed": null,
              "entry": null
            },
            "score": "6-3 6-4 6-0",
            "status": "completed"
          },
          {
            "id": "mt_r2d8yx7h",
            "date": "2026-08-30",
            "next_match": "mt_9c8njtaa",
            "winner": {
              "id": "pl_h0zfh019",
              "name": "Shapovalov D.",
              "country": "Canada",
              "seed": null,
              "entry": null
            },
            "loser": {
              "id": "pl_tf7zyk4e",
              "name": "Kecmanovic M.",
              "country": "Serbia",
              "seed": null,
              "entry": null
            },
            "score": "6-4 4-6 6-4 6-1",
            "status": "completed"
          },
          {
            "id": "mt_fwdmnnp1",
            "date": "2026-08-30",
            "next_match": "mt_74hs7cn0",
            "winner": {
              "id": "pl_6ys8jhyh",
              "name": "Samuel T.",
              "country": "United Kingdom",
              "seed": null,
              "entry": null
            },
            "loser": {
              "id": "pl_wr4sjsj9",
              "name": "Machac T.",
              "country": "Czech Republic",
              "seed": null,
              "entry": null
            },
            "score": "6-2 6-3 6-2",
            "status": "completed"
          },
          "..."
        ]
      },
      {
        "round": "round_2",
        "matches": [
          {
            "id": "mt_ekh8asv8",
            "date": "2026-09-02",
            "next_match": "mt_4yjmtg6x",
            "winner": {
              "id": "pl_2yx88rqn",
              "name": "Tsitsipas S.",
              "country": "Greece",
              "seed": null,
              "entry": null
            },
            "loser": {
              "id": "pl_vc6ehyet",
              "name": "Harris L.",
              "country": "South Africa",
              "seed": null,
              "entry": null
            },
            "score": "6-7(1) 6-3 7-6(4) 6-4",
            "status": "completed"
          },
          {
            "id": "mt_9c8njtaa",
            "date": "2026-09-02",
            "next_match": "mt_4shtr993",
            "winner": {
              "id": "pl_h0zfh019",
              "name": "Shapovalov D.",
              "country": "Canada",
              "seed": null,
              "entry": null
            },
            "loser": {
              "id": "pl_7npr0gfv",
              "name": "Van Assche L.",
              "country": "France",
              "seed": null,
              "entry": null
            },
            "score": "6-0 6-4 7-6(7)",
            "status": "completed"
          },
          {
            "id": "mt_4dfdzgfs",
            "date": "2026-09-02",
            "next_match": "mt_4c4axgwb",
            "winner": {
              "id": "pl_88qkmdfj",
              "name": "Etcheverry T.",
              "country": "Argentina",
              "seed": 27,
              "entry": null
            },
            "loser": {
              "id": "pl_5s0zcbq9",
              "name": "Fearnley J.",
              "country": "United Kingdom",
              "seed": null,
              "entry": null
            },
            "score": "6-3 6-3 3-6 6-3",
            "status": "completed"
          },
          "..."
        ]
      },
      "..."
    ]
  },
  "meta": { "matches": 239 }
}

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

4Fields

FieldTypeWhat it holds
tournament, season, draw_size, championmixedThe season, its draw size where known, and the champion
roundsarrayFrom qualifying to the final: round and its matches, each player with seed and entry (Q, WC, LL, PR, SE, ALT)

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.
403upgrade_requiredThe free key: this endpoint is on the Live plan and above.
404not_foundNo such id, or no such season of this tournament.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).