GET
https://api.tennisdatabaseapi.com/v1/matches/{id}Every planOne match: score, every bookmaker's price with its opening price, the games and sets lines, correct score prices, price movement and the full statistics.
Free key yesterday on, no pricesLive 45 daysArchive every seasonComplete everything
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213
1Parameters
| Name | What it is |
|---|---|
idrequired | An id from another answer, such as mt_ 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/matches/mt_9e5aq213"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213'); 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/matches/mt_9e5aq213", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213", { 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": {
"id": "mt_9e5aq213",
"date": "2026-09-13",
"start_time": "2026-09-13T18:20:00Z",
"tour": "men",
"event_type": "singles",
"tournament": {
"id": "tn_1d50xrzv",
"name": "US Open",
"event_known": true,
"tier": "slam",
"season": 2026,
"surface": "hard"
},
"round": "final",
"winner": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
"loser": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
"score": "6-3 7-6(2) 5-7 6-2",
"sets": { "winner": 3, "loser": 1 },
"status": "completed",
"best_of": 5,
"ranks": { "winner": 2, "loser": 9 },
"ranking_points": { "winner": 7790, "loser": 3480 },
"odds": {
"closing": { "winner": 1.67, "loser": 2.2 },
"bookmakers": {
"10bet": {
"winner": 1.67,
"loser": 2.15,
"opened": { "winner": 1.65, "loser": null }
},
"1xbet": {
"winner": 1.59,
"loser": 2.38,
"opened": { "winner": 1.72, "loser": 2.31 }
},
"bet365": {
"winner": 1.67,
"loser": 2.3,
"opened": { "winner": 1.7, "loser": 2.25 }
},
"bet_at_home": {
"winner": 1.68,
"loser": 2.2,
"opened": { "winner": 1.65, "loser": null }
},
"betfair": {
"winner": 1.67,
"loser": 2.33,
"opened": { "winner": 1.63, "loser": 2.27 }
},
"betsson": {
"winner": 1.68,
"loser": 2.13,
"opened": { "winner": 1.65, "loser": 2.19 }
},
"betvictor": {
"winner": 1.62,
"loser": 2.25,
"opened": { "winner": 1.67, "loser": 2.2 }
},
"betway": { "winner": 1.65, "loser": 2.3 },
"bwin": {
"winner": 1.7,
"loser": 2.2,
"opened": { "winner": 1.65, "loser": 2.3 }
},
"coral": {
"winner": 1.65,
"loser": 2.15,
"opened": { "winner": 1.6, "loser": 2.2 }
},
"exchange": { "winner": 1.72, "loser": 2.36 },
"interwetten": {
"winner": 1.63,
"loser": 2.25,
"opened": { "winner": 1.65, "loser": 2.2 }
},
"ladbrokes": {
"winner": 1.65,
"loser": 2.15,
"opened": { "winner": 1.6, "loser": 2.2 }
},
"market_average": { "winner": 1.67, "loser": 2.2 },
"market_best": { "winner": 1.7, "loser": 2.3 },
"market_consensus": { "winner": 1.66, "loser": 2.24 },
"pinnacle": {
"winner": 1.71,
"loser": 2.27,
"opened": { "winner": 1.67, "loser": 2.33 }
},
"unibet": {
"winner": 1.62,
"loser": 2.35,
"opened": { "winner": 1.68, "loser": 2.2 }
},
"william_hill": { "winner": 1.67, "loser": 2.2 }
},
"markets": {
"correct_score": [
{ "score": "0:3", "bookmaker": "10bet", "price": 6.5 },
{ "score": "0:3", "bookmaker": "bet365", "price": 7 },
{ "score": "0:3", "bookmaker": "bet_at_home", "price": 6 },
"..."
],
"handicap_games": [
{
"line": -5.5,
"bookmaker": "1xbet",
"winner": 4.4,
"loser": 1.21,
"opened": { "winner": 4.05, "loser": 1.23 }
},
{
"line": -5.5,
"bookmaker": "bet_at_home",
"winner": 4,
"loser": 1.23,
"opened": { "winner": 3.95, "loser": 1.2 }
},
{
"line": -5.5,
"bookmaker": "interwetten",
"winner": 4,
"loser": 1.2,
"opened": { "winner": 3.8, "loser": 1.22 }
},
"..."
],
"handicap_sets": [
{
"line": -2.5,
"bookmaker": "10bet",
"winner": 4.33,
"loser": 1.18,
"opened": { "winner": 4, "loser": 1.2 }
},
{
"line": -2.5,
"bookmaker": "1xbet",
"winner": 4.3,
"loser": 1.21,
"opened": { "winner": 4.2, "loser": 1.22 }
},
{
"line": -2.5,
"bookmaker": "bet_at_home",
"winner": 4.3,
"loser": 1.18,
"opened": { "winner": 4.1, "loser": 1.2 }
},
"..."
],
"total_games": [
{ "line": 34.5, "bookmaker": "unibet", "over": 1.25, "under": 3.8 },
{
"line": 35.5,
"bookmaker": "bet_at_home",
"over": 1.35,
"under": 3,
"opened": { "over": null, "under": 2.95 }
},
{ "line": 35.5, "bookmaker": "market_average", "over": 1.34, "under": 3.13 },
"..."
],
"total_sets": [
{
"line": 3.5,
"bookmaker": "bet_at_home",
"over": 1.4,
"under": 2.8,
"opened": { "over": null, "under": 2.7 }
},
{ "line": 3.5, "bookmaker": "betsson", "over": 1.4, "under": 2.75 },
{
"line": 3.5,
"bookmaker": "betway",
"over": 1.36,
"under": 3,
"opened": { "over": 1.4, "under": 2.7 }
},
"..."
]
},
"movement": {
"10bet": {
"winner": [
["2026-09-12 11:15", 1.65],
["2026-09-13 20:03", 1.67]
]
},
"1xbet": {
"loser": [
["2026-09-12 06:16", 2.31],
["2026-09-13 19:57", 2.38]
],
"winner": [
["2026-09-12 06:16", 1.72],
["2026-09-13 19:57", 1.59]
]
},
"bet365": {
"loser": [
["2026-09-12 05:28", 2.25],
["2026-09-12 07:01", 2.3]
],
"winner": [
["2026-09-12 05:28", 1.7],
["2026-09-12 07:01", 1.67]
]
},
"bet_at_home": {
"winner": [
["2026-09-12 06:15", 1.65],
["2026-09-13 19:56", 1.68]
]
},
"betfair": {
"loser": [
["2026-09-12 06:14", 2.27],
["2026-09-13 19:53", 2.33]
],
"winner": [
["2026-09-12 06:14", 1.63],
["2026-09-13 19:53", 1.67]
]
},
"betsson": {
"loser": [
["2026-09-12 05:24", 2.19],
["2026-09-13 19:59", 2.13]
],
"winner": [
["2026-09-12 05:24", 1.65],
["2026-09-13 19:59", 1.68]
]
},
"betvictor": {
"loser": [
["2026-09-12 05:20", 2.2],
["2026-09-13 19:58", 2.25]
],
"winner": [
["2026-09-12 05:20", 1.67],
["2026-09-13 19:58", 1.62]
]
},
"bwin": {
"loser": [
["2026-09-12 06:12", 2.3],
["2026-09-13 20:00", 2.2]
],
"winner": [
["2026-09-12 06:12", 1.65],
["2026-09-13 20:00", 1.7]
]
},
"coral": {
"loser": [
["2026-09-12 06:12", 2.2],
["2026-09-13 19:51", 2.15]
],
"winner": [
["2026-09-12 06:12", 1.6],
["2026-09-13 19:51", 1.65]
]
},
"interwetten": {
"loser": [
["2026-09-12 05:24", 2.2],
["2026-09-13 15:40", 2.25]
],
"winner": [
["2026-09-12 05:24", 1.65],
["2026-09-13 15:40", 1.63]
]
},
"ladbrokes": {
"loser": [
["2026-09-12 06:12", 2.2],
["2026-09-13 19:52", 2.15]
],
"winner": [
["2026-09-12 06:12", 1.6],
["2026-09-13 19:52", 1.65]
]
},
"pinnacle": {
"loser": [
["2026-09-12 06:08", 2.33],
["2026-09-13 19:58", 2.27]
],
"winner": [
["2026-09-12 06:08", 1.67],
["2026-09-13 19:58", 1.71]
]
},
"unibet": {
"loser": [
["2026-09-12 05:58", 2.2],
["2026-09-13 20:09", 2.35]
],
"winner": [
["2026-09-12 05:58", 1.68],
["2026-09-13 20:09", 1.62]
]
}
}
},
"stats": {
"match": {
"first_return_points_won": {
"winner": { "pct": 29, "won": 25, "of": 87 },
"loser": { "pct": 15, "won": 12, "of": 80 }
},
"first_serve_in": {
"winner": { "pct": 69 },
"loser": { "pct": 71 }
},
"first_serve_points_won": {
"winner": { "pct": 85, "won": 68, "of": 80 },
"loser": { "pct": 71, "won": 62, "of": 87 }
},
"second_return_points_won": {
"winner": { "pct": 43, "won": 15, "of": 35 },
"loser": { "pct": 53, "won": 19, "of": 36 }
},
"second_serve_points_won": {
"winner": { "pct": 47, "won": 17, "of": 36 },
"loser": { "pct": 57, "won": 20, "of": 35 }
},
"aces": { "winner": 9, "loser": 10 },
"first_serve_speed_kmh": { "winner": 213, "loser": 192 },
"second_serve_speed_kmh": { "winner": 181, "loser": 164 },
"break_points_won": {
"winner": { "won": 4, "of": 6 },
"loser": { "won": 1, "of": 3 }
},
"break_points_saved": {
"winner": { "won": 2, "of": 3 },
"loser": { "won": 2, "of": 6 }
},
"distance_covered_metres": { "winner": 2637, "loser": 2883 },
"double_faults": { "winner": 6, "loser": 4 },
"last_10_points": { "winner": 8, "loser": 2 },
"match_points_saved": { "winner": 0, "loser": 0 },
"net_points_won": {
"winner": { "pct": 86, "won": 25, "of": 29 },
"loser": { "pct": 69, "won": 29, "of": 42 }
},
"return_points_won": {
"winner": { "pct": 33, "won": 40, "of": 122 },
"loser": { "pct": 27, "won": 31, "of": 116 }
},
"return_games_won": {
"winner": { "pct": 19, "won": 4, "of": 21 },
"loser": { "pct": 5, "won": 1, "of": 20 }
},
"service_points_won": {
"winner": { "pct": 73, "won": 85, "of": 116 },
"loser": { "pct": 67, "won": 82, "of": 122 }
},
"service_games_won": {
"winner": { "pct": 95, "won": 19, "of": 20 },
"loser": { "pct": 81, "won": 17, "of": 21 }
},
"total_points_won": {
"winner": { "pct": 53, "won": 125, "of": 238 },
"loser": { "pct": 47, "won": 113, "of": 238 }
},
"total_games_won": {
"winner": { "pct": 56, "won": 23, "of": 41 },
"loser": { "pct": 44, "won": 18, "of": 41 }
},
"unforced_errors": { "winner": 31, "loser": 47 },
"winners": { "winner": 35, "loser": 47 }
},
"set_1": {
"first_return_points_won": {
"winner": { "pct": 35, "won": 6, "of": 17 },
"loser": { "pct": 6, "won": 1, "of": 16 }
},
"first_serve_in": {
"winner": { "pct": 70 },
"loser": { "pct": 61 }
},
"first_serve_points_won": {
"winner": { "pct": 94, "won": 15, "of": 16 },
"loser": { "pct": 65, "won": 11, "of": 17 }
},
"second_return_points_won": {
"winner": { "pct": 45, "won": 5, "of": 11 },
"loser": { "pct": 86, "won": 6, "of": 7 }
},
"second_serve_points_won": {
"winner": { "pct": 14, "won": 1, "of": 7 },
"loser": { "pct": 55, "won": 6, "of": 11 }
},
"aces": { "winner": 1, "loser": 4 },
"break_points_won": {
"winner": { "won": 2, "of": 2 },
"loser": { "won": 0, "of": 0 }
},
"break_points_saved": {
"winner": { "won": 0, "of": 0 },
"loser": { "won": 0, "of": 2 }
},
"distance_covered_metres": { "winner": 444, "loser": 473 },
"double_faults": { "winner": 2, "loser": 2 },
"match_points_saved": { "winner": 0, "loser": 0 },
"net_points_won": {
"winner": { "pct": 83, "won": 5, "of": 6 },
"loser": { "pct": 75, "won": 6, "of": 8 }
},
"return_points_won": {
"winner": { "pct": 39, "won": 11, "of": 28 },
"loser": { "pct": 30, "won": 7, "of": 23 }
},
"return_games_won": {
"winner": { "pct": 40, "won": 2, "of": 5 },
"loser": { "pct": 0, "won": 0, "of": 4 }
},
"service_points_won": {
"winner": { "pct": 70, "won": 16, "of": 23 },
"loser": { "pct": 61, "won": 17, "of": 28 }
},
"service_games_won": {
"winner": { "pct": 100, "won": 4, "of": 4 },
"loser": { "pct": 60, "won": 3, "of": 5 }
},
"total_points_won": {
"winner": { "pct": 53, "won": 27, "of": 51 },
"loser": { "pct": 47, "won": 24, "of": 51 }
},
"total_games_won": {
"winner": { "pct": 67, "won": 6, "of": 9 },
"loser": { "pct": 33, "won": 3, "of": 9 }
},
"unforced_errors": { "winner": 9, "loser": 11 },
"winners": { "winner": 8, "loser": 8 }
},
"set_2": {
"first_return_points_won": {
"winner": { "pct": 28, "won": 9, "of": 32 },
"loser": { "pct": 8, "won": 2, "of": 26 }
},
"first_serve_in": {
"winner": { "pct": 67 },
"loser": { "pct": 76 }
},
"first_serve_points_won": {
"winner": { "pct": 92, "won": 24, "of": 26 },
"loser": { "pct": 72, "won": 23, "of": 32 }
},
"second_return_points_won": {
"winner": { "pct": 40, "won": 4, "of": 10 },
"loser": { "pct": 46, "won": 6, "of": 13 }
},
"second_serve_points_won": {
"winner": { "pct": 54, "won": 7, "of": 13 },
"loser": { "pct": 60, "won": 6, "of": 10 }
},
"aces": { "winner": 5, "loser": 3 },
"break_points_won": {
"winner": { "won": 0, "of": 1 },
"loser": { "won": 0, "of": 0 }
},
"break_points_saved": {
"winner": { "won": 0, "of": 0 },
"loser": { "won": 1, "of": 1 }
},
"distance_covered_metres": { "winner": 873, "loser": 940 },
"double_faults": { "winner": 3, "loser": 1 },
"match_points_saved": { "winner": 0, "loser": 0 },
"net_points_won": {
"winner": { "pct": 100, "won": 5, "of": 5 },
"loser": { "pct": 62, "won": 8, "of": 13 }
},
"return_points_won": {
"winner": { "pct": 31, "won": 13, "of": 42 },
"loser": { "pct": 21, "won": 8, "of": 39 }
},
"return_games_won": {
"winner": { "pct": 0, "won": 0, "of": 6 },
"loser": { "pct": 0, "won": 0, "of": 6 }
},
"service_points_won": {
"winner": { "pct": 79, "won": 31, "of": 39 },
"loser": { "pct": 69, "won": 29, "of": 42 }
},
"service_games_won": {
"winner": { "pct": 100, "won": 6, "of": 6 },
"loser": { "pct": 100, "won": 6, "of": 6 }
},
"total_points_won": {
"winner": { "pct": 54, "won": 44, "of": 81 },
"loser": { "pct": 46, "won": 37, "of": 81 }
},
"total_games_won": {
"winner": { "pct": 50, "won": 6, "of": 12 },
"loser": { "pct": 50, "won": 6, "of": 12 }
},
"unforced_errors": { "winner": 9, "loser": 18 },
"winners": { "winner": 10, "loser": 17 }
},
"set_3": {
"first_return_points_won": {
"winner": { "pct": 10, "won": 2, "of": 21 },
"loser": { "pct": 31, "won": 8, "of": 26 }
},
"first_serve_in": {
"winner": { "pct": 76 },
"loser": { "pct": 75 }
},
"first_serve_points_won": {
"winner": { "pct": 69, "won": 18, "of": 26 },
"loser": { "pct": 90, "won": 19, "of": 21 }
},
"second_return_points_won": {
"winner": { "pct": 29, "won": 2, "of": 7 },
"loser": { "pct": 50, "won": 4, "of": 8 }
},
"second_serve_points_won": {
"winner": { "pct": 50, "won": 4, "of": 8 },
"loser": { "pct": 71, "won": 5, "of": 7 }
},
"aces": { "winner": 2, "loser": 2 },
"break_points_won": {
"winner": { "won": 0, "of": 0 },
"loser": { "won": 1, "of": 3 }
},
"break_points_saved": {
"winner": { "won": 2, "of": 3 },
"loser": { "won": 0, "of": 0 }
},
"distance_covered_metres": { "winner": 633, "loser": 702 },
"double_faults": { "winner": 0, "loser": 0 },
"match_points_saved": { "winner": 0, "loser": 0 },
"net_points_won": {
"winner": { "pct": 67, "won": 6, "of": 9 },
"loser": { "pct": 80, "won": 8, "of": 10 }
},
"return_points_won": {
"winner": { "pct": 14, "won": 4, "of": 28 },
"loser": { "pct": 35, "won": 12, "of": 34 }
},
"return_games_won": {
"winner": { "pct": 0, "won": 0, "of": 6 },
"loser": { "pct": 17, "won": 1, "of": 6 }
},
"service_points_won": {
"winner": { "pct": 65, "won": 22, "of": 34 },
"loser": { "pct": 86, "won": 24, "of": 28 }
},
"service_games_won": {
"winner": { "pct": 83, "won": 5, "of": 6 },
"loser": { "pct": 100, "won": 6, "of": 6 }
},
"total_points_won": {
"winner": { "pct": 42, "won": 26, "of": 62 },
"loser": { "pct": 58, "won": 36, "of": 62 }
},
"total_games_won": {
"winner": { "pct": 42, "won": 5, "of": 12 },
"loser": { "pct": 58, "won": 7, "of": 12 }
},
"unforced_errors": { "winner": 11, "loser": 7 },
"winners": { "winner": 10, "loser": 14 }
},
"set_4": {
"first_return_points_won": {
"winner": { "pct": 47, "won": 8, "of": 17 },
"loser": { "pct": 8, "won": 1, "of": 12 }
},
"first_serve_in": {
"winner": { "pct": 60 },
"loser": { "pct": 71 }
},
"first_serve_points_won": {
"winner": { "pct": 92, "won": 11, "of": 12 },
"loser": { "pct": 53, "won": 9, "of": 17 }
},
"second_return_points_won": {
"winner": { "pct": 57, "won": 4, "of": 7 },
"loser": { "pct": 38, "won": 3, "of": 8 }
},
"second_serve_points_won": {
"winner": { "pct": 63, "won": 5, "of": 8 },
"loser": { "pct": 43, "won": 3, "of": 7 }
},
"aces": { "winner": 1, "loser": 1 },
"break_points_won": {
"winner": { "won": 2, "of": 3 },
"loser": { "won": 0, "of": 0 }
},
"break_points_saved": {
"winner": { "won": 0, "of": 0 },
"loser": { "won": 1, "of": 3 }
},
"distance_covered_metres": { "winner": 687, "loser": 768 },
"double_faults": { "winner": 1, "loser": 1 },
"match_points_saved": { "winner": 0, "loser": 0 },
"net_points_won": {
"winner": { "pct": 100, "won": 9, "of": 9 },
"loser": { "pct": 64, "won": 7, "of": 11 }
},
"return_points_won": {
"winner": { "pct": 50, "won": 12, "of": 24 },
"loser": { "pct": 20, "won": 4, "of": 20 }
},
"return_games_won": {
"winner": { "pct": 50, "won": 2, "of": 4 },
"loser": { "pct": 0, "won": 0, "of": 4 }
},
"service_points_won": {
"winner": { "pct": 80, "won": 16, "of": 20 },
"loser": { "pct": 50, "won": 12, "of": 24 }
},
"service_games_won": {
"winner": { "pct": 100, "won": 4, "of": 4 },
"loser": { "pct": 50, "won": 2, "of": 4 }
},
"total_points_won": {
"winner": { "pct": 64, "won": 28, "of": 44 },
"loser": { "pct": 36, "won": 16, "of": 44 }
},
"total_games_won": {
"winner": { "pct": 75, "won": 6, "of": 8 },
"loser": { "pct": 25, "won": 2, "of": 8 }
},
"unforced_errors": { "winner": 2, "loser": 11 },
"winners": { "winner": 7, "loser": 8 }
}
},
"duration_minutes": 216,
"set_minutes": [41, 71, 60, 44],
"umpire": "Veljovic M.",
"court": {
"venue": "Arthur Ashe Stadium",
"city": "New York, NY",
"indoor": false,
"coordinates": { "latitude": 40.75, "longitude": -73.8475, "of": "venue" }
},
"weather": null,
"draw": {
"next_match": null,
"from_matches": ["mt_yqmv7sh8", "mt_qvs9vycz"]
},
"point_by_point": {
"summary": {
"winner": { "service_games": 20, "held": 19, "break_points_faced": 3, "deuce_games": 3, "broken": 1 },
"loser": { "service_games": 21, "held": 17, "break_points_faced": 6, "deuce_games": 5, "broken": 4 }
},
"games": [
{
"set": 1,
"game": 1,
"tiebreak": false,
"server": "loser",
"won_by": "winner",
"break": true,
"games_after": { "winner": 1, "loser": 0 },
"points": ["15-0", "30-0", "30-15", "30-30", "40-30"],
"break_points": [4],
"set_points": []
},
{
"set": 1,
"game": 2,
"tiebreak": false,
"server": "winner",
"won_by": "winner",
"break": false,
"games_after": { "winner": 2, "loser": 0 },
"points": ["15-0", "15-15", "30-15", "40-15"],
"break_points": [],
"set_points": []
},
{
"set": 1,
"game": 3,
"tiebreak": false,
"server": "loser",
"won_by": "loser",
"break": false,
"games_after": { "winner": 2, "loser": 1 },
"points": ["0-15", "0-30", "0-40"],
"break_points": [],
"set_points": []
},
"..."
]
}
},
"meta": {}
}{
"data": {
"id": "mt_64st2j26",
"date": "2026-11-17",
"start_time": null,
"tour": "women",
"event_type": "singles",
"tournament": {
"id": "tn_7xh4qdg6",
"name": "Alcala de Henares ITF",
"event_known": true,
"tier": "itf",
"season": 2026,
"surface": "hard"
},
"round": "qualifying",
"winner": { "id": "pl_280s09jj", "name": "Teixido Garcia A.", "country": "Spain" },
"loser": { "id": "pl_rvsa9ee4", "name": "Marentes Melnikova N.", "country": "Spain" },
"score": "6-1 6-1",
"sets": { "winner": 2, "loser": 0 },
"status": "completed",
"best_of": null,
"ranks": null,
"ranking_points": null,
"odds": null,
"stats": null,
"duration_minutes": null,
"set_minutes": null,
"umpire": null,
"court": { "venue": null, "city": null, "indoor": false, "coordinates": null },
"weather": null,
"draw": null,
"point_by_point": null
},
"meta": {}
}{
"error": {
"code": "upgrade_required",
"message": "Your plan does not read matches on 2026-09-13.",
"plan": "Archive",
"upgrade": "https://tennisdatabaseapi.com/pricing",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}The answer above is a real one: the US Open 2026 final, won by Zverev Alexander. Long lists are cut to three items here.
A field your plan does not include is still there, as
null, so code written on the free key keeps working after an upgrade. meta.held_back names what was held back and meta.note the plan that adds it.4Fields
| Field | What it holds |
|---|---|
id | The match id, mt_ and 8 characters |
date | The day it was played, UTC |
start_time | When play began (or is set to begin) on the match's date, UTC, as listed for that day; for a match finished on a later day, the time it resumed that day; null where not known |
tournament | id, name, event_known, tier, season, surface |
round | final, semi_final, quarter_final, round_of_16, round_1, qualifying and so on |
winner, loser | id, name, country |
score | The score from the winner's side, tie-breaks in brackets |
sets | Sets won by the winner and the loser |
status | completed, retired, walkover or defaulted |
best_of | 3 or 5 |
ranks | Each player's ranking on the day, where known |
ranking_points | Each player's ranking points on the day, where known (from the same weekly list as the ranking) |
odds.closing | The market's closing prices for the winner and the loser, decimal |
odds.bookmakers | Each bookmaker's closing price, with opened where the opening price is known |
odds.markets | total_games, total_sets, handicap_games, handicap_sets, correct_score |
odds.movement | Every recorded change of each bookmaker's price, oldest first, as [time, price] |
stats | By period (match, set_1, ...): aces, double faults, serve and return points, break points, winners and more, each for the winner and the loser |
point_by_point | Every game in order: who served, who won it, breaks, every point, with break_points and the server's set_points (set or match points) marked |
duration_minutes | The match length, with set_minutes per set where known |
umpire, court | The umpire, and the court: venue, city, indoor (true or false) and coordinates (latitude, longitude, and of: venue or city), each where known |
draw | In a knockout main draw: next_match (where the winner went on) and from_matches (the matches whose winners met here); null for qualifying, round robins and team events |
weather | Outdoor matches from mid-2020: temperature_c, humidity_pct, wind_kmh, wind_from_deg, precipitation_mm_h and cloud_cover_pct from a weather model's analysis at the court, at the time nearest the start (at; timed false where the start is not known) |
5Errors
unauthorized | No key, or a key that is unknown or revoked. |
upgrade_required | A date outside your plan's window; the error names the plan that reads it. |
not_found | No such id. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |