GET
https://api.tennisdatabaseapi.com/v1/fixturesEvery planThe 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
| Name | What it is |
|---|---|
tour | Men or women: men, women. |
tier | The level of the event: slam, tour, challenger, itf, utr, team, other. |
tournament | A tournament id. |
page, per_page | Paging: 50 a page unless you ask, at most 50. See Paging. |
cursor | The 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"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/fixtures?per_page=2'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('TDA_KEY')], CURLOPT_RETURNTRANSFER => true, ]); $answer = json_decode(curl_exec($ch), true); print_r($answer['data']);
import os, requests r = requests.get( "https://api.tennisdatabaseapi.com/v1/fixtures?per_page=2", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/fixtures?per_page=2", { headers: { Authorization: `Bearer ${process.env.TDA_KEY}` }, }); const { data } = await r.json(); console.log(data);
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
}
}{
"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,
"held_back": ["odds"],
"note": "Prices before play are on the Live plan and above."
}
}{
"error": {
"code": "bad_request",
"message": "tier is one of: slam, tour, challenger, itf, utr, team, other.",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}Real answers from the API, made 2026-11-18. Long lists are cut to three items here.
4Fields
| Field | What it holds |
|---|---|
start_time, status | When 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, round | As in every match answer: the tournament with its id, name, tier, season and surface |
player_1, player_2 | In the order of play: player (id, name, country), the current rank and elo |
elo_chance | The chance each player's Elo rating gives them, player_1 and player_2, where both are rated. A rating, not a tip |
odds | The 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_of | When the list was read, UTC |
5Errors
bad_request | A value out of range, such as a date or a tier that is not one of the list. |
unauthorized | No key, or a key that is unknown or revoked. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |