tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsMatchesFixtures
Matches

Fixtures

MCP tool fixtures
GEThttps://api.tennisdatabaseapi.com/v1/fixturesEvery plan

The matches set to be played, from those under way to two days ahead: start time, round, both players with ranking and Elo, the chance Elo gives each, and the price before play where the market has one.

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/fixtures?per_page=2

1Parameters

NameInTypeWhat it is
tourquerystringMen or women: men, women.
tierquerystringThe level of the event: slam, tour, challenger, itf, utr, team, other.
tournamentqueryidA tournament id.
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/fixtures?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": [
    {
      "start_time": "2026-11-18T03:00:00Z",
      "status": "started",
      "tour": "men",
      "tournament": {
        "id": "tn_3f91ggzq",
        "name": "M15 Kuala Lumpur 2",
        "tier": "itf",
        "season": 2026,
        "surface": "hard"
      },
      "round": null,
      "player_1": {
        "player": { "id": "pl_8dgnyqw8", "name": "Cherie Ligniere E.", "country": "Italy" },
        "rank": 1116,
        "elo": 1835
      },
      "player_2": {
        "player": { "id": "pl_82pe7d1j", "name": "Lomakin G.", "country": "Kazakhstan" },
        "rank": 851,
        "elo": 1703
      },
      "elo_chance": { "player_1": 0.681, "player_2": 0.319 },
      "odds": null
    },
    {
      "start_time": "2026-11-18T03:00:00Z",
      "status": "started",
      "tour": "men",
      "tournament": {
        "id": "tn_3f91ggzq",
        "name": "M15 Kuala Lumpur 2",
        "tier": "itf",
        "season": 2026,
        "surface": "hard"
      },
      "round": null,
      "player_1": {
        "player": { "id": "pl_5rkpyn7r", "name": "Yamamoto N.", "country": "Japan" },
        "rank": 2078,
        "elo": 1614
      },
      "player_2": {
        "player": { "id": "pl_1rx6qvcz", "name": "Alam S.", "country": "Singapore" },
        "rank": null,
        "elo": 1461
      },
      "elo_chance": { "player_1": 0.707, "player_2": 0.293 },
      "odds": null
    }
  ],
  "meta": {
    "as_of": "2026-11-18T05:21:02Z",
    "count": 2,
    "next_cursor": "eyJvIjoyLCJwIjoyfQ",
    "page": 1,
    "per_page": 2,
    "total": 365,
    "total_pages": 183,
    "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
start_time, statusmixedWhen the match is set to start, UTC, and scheduled or started (under way or about to be, no result yet). A match leaves the list when its result arrives, and is then in Matches on a day
tour, tournament, roundmixedAs in every match answer: the tournament with its id, name, tier, season and surface
player_1, player_2objectIn the order of play: player (id, name, country), the current rank and elo
elo_chanceobjectThe chance each player's Elo rating gives them, player_1 and player_2, where both are rated. A rating, not a tip
oddsobjectThe price before play, decimal, for player_1 and player_2, with as_of: when it was read (every 10 minutes, for matches set for today and tomorrow). null where the market has no price yet, and on plans without prices before play (see meta.held_back). Every bookmaker's price and the price moves follow on Match prices and Price moves once the match is played
meta.as_ofstringWhen the list was read, UTC

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