tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsTournamentsFind tournaments
Tournaments

Find tournaments

MCP tool find_tournament
GEThttps://api.tennisdatabaseapi.com/v1/tournamentsEvery plan

Tournaments, by name, tour or tier.

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?search=us&per_page=2

1Parameters

NameInTypeWhat it is
searchquerystringPart of the name.
tourquerystringMen or women: men, women.
tierquerystringThe level of the event: slam, tour, challenger, itf, utr, team, other.
page, per_pagequeryintegerPaging: 50 a page unless you ask, at most 50. See Paging.
cursorquerystringThe meta.next_cursor of the page before, to walk a long list.

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?search=us&per_page=2"

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": "tn_ab0jpcss",
      "name": "Australian Open",
      "event_known": true,
      "tour": "women",
      "tier": "slam",
      "surface": "hard",
      "first_season": 1968,
      "last_season": 2026
    },
    {
      "id": "tn_qrrczgdw",
      "name": "Australian Open",
      "event_known": true,
      "tour": "men",
      "tier": "slam",
      "surface": "hard",
      "first_season": 1905,
      "last_season": 2026
    }
  ],
  "meta": {
    "count": 2,
    "next_cursor": "eyJvIjoyLCJwIjoyfQ",
    "page": 1,
    "per_page": 2,
    "total": 797,
    "total_pages": 399,
    "next_page": 2,
    "prev_page": null
  }
}

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

4Fields

FieldTypeWhat it holds
idstringThe tournament id, tn_ and 8 characters
namestringThe event's name
event_knownbooleanfalse for the one row a season holding men's ITF matches whose event is not recorded
tour, tierstringmen or women; slam, tour, challenger, itf, utr, team, other
surfacestringclay, grass, hard, hard_indoor, carpet
first_season, last_seasonintegerThe first and latest season held

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