GET
https://api.tennisdatabaseapi.com/v1/matches/{id}/statisticsEvery planServe and return figures for each player, for the match and each set, with the service games held and broken.
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/matches/mt_9e5aq213/statistics
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/statistics"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213/statistics'); 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/statistics", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213/statistics", { 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",
"tournament": { "id": "tn_1d50xrzv", "name": "US Open" },
"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",
"duration_minutes": 216,
"set_minutes": [41, 71, 60, 44],
"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 }
}
},
"service": {
"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 }
}
},
"meta": {}
}{
"data": {
"id": "mt_vnw6xw60",
"date": "2026-11-17",
"tournament": { "id": "tn_myexzbe8", "name": "Sydney challenger" },
"round": "round_1",
"winner": { "id": "pl_avq2ykv7", "name": "Broska F.", "country": "Germany" },
"loser": { "id": "pl_a0jt847c", "name": "Hoole C.", "country": "Australia" },
"score": "7-5 6-4",
"duration_minutes": 88,
"set_minutes": [43, 45],
"stats": {
"match": {
"first_return_points_won": {
"winner": { "pct": 36, "won": 18, "of": 50 },
"loser": { "pct": 29, "won": 14, "of": 49 }
},
"first_serve_in": {
"winner": { "pct": 68 },
"loser": { "pct": 67 }
},
"first_serve_points_won": {
"winner": { "pct": 71, "won": 35, "of": 49 },
"loser": { "pct": 64, "won": 32, "of": 50 }
},
"second_return_points_won": {
"winner": { "pct": 52, "won": 13, "of": 25 },
"loser": { "pct": 48, "won": 11, "of": 23 }
},
"second_serve_points_won": {
"winner": { "pct": 52, "won": 12, "of": 23 },
"loser": { "pct": 48, "won": 12, "of": 25 }
},
"aces": { "winner": 4, "loser": 10 },
"break_points_won": {
"winner": { "won": 3, "of": 11 },
"loser": { "won": 1, "of": 4 }
},
"break_points_saved": {
"winner": { "won": 3, "of": 4 },
"loser": { "won": 8, "of": 11 }
},
"double_faults": { "winner": 3, "loser": 1 },
"last_10_points": { "winner": 6, "loser": 4 },
"match_points_saved": { "winner": 0, "loser": 1 },
"return_points_won": {
"winner": { "pct": 41, "won": 31, "of": 75 },
"loser": { "pct": 34, "won": 23, "of": 68 }
},
"return_games_won": {
"winner": { "pct": 27, "won": 3, "of": 11 },
"loser": { "pct": 9, "won": 1, "of": 11 }
},
"service_points_won": {
"winner": { "pct": 66, "won": 45, "of": 68 },
"loser": { "pct": 59, "won": 44, "of": 75 }
},
"service_games_won": {
"winner": { "pct": 91, "won": 10, "of": 11 },
"loser": { "pct": 73, "won": 8, "of": 11 }
},
"total_points_won": {
"winner": { "pct": 53, "won": 76, "of": 143 },
"loser": { "pct": 47, "won": 67, "of": 143 }
},
"total_games_won": {
"winner": { "pct": 59, "won": 13, "of": 22 },
"loser": { "pct": 41, "won": 9, "of": 22 }
}
},
"set_1": {
"first_return_points_won": {
"winner": { "pct": 33, "won": 7, "of": 21 },
"loser": { "pct": 32, "won": 11, "of": 34 }
},
"first_serve_in": {
"winner": { "pct": 76 },
"loser": { "pct": 70 }
},
"first_serve_points_won": {
"winner": { "pct": 68, "won": 23, "of": 34 },
"loser": { "pct": 67, "won": 14, "of": 21 }
},
"second_return_points_won": {
"winner": { "pct": 22, "won": 2, "of": 9 },
"loser": { "pct": 45, "won": 5, "of": 11 }
},
"second_serve_points_won": {
"winner": { "pct": 55, "won": 6, "of": 11 },
"loser": { "pct": 78, "won": 7, "of": 9 }
},
"aces": { "winner": 2, "loser": 2 },
"break_points_won": {
"winner": { "won": 1, "of": 4 },
"loser": { "won": 0, "of": 1 }
},
"break_points_saved": {
"winner": { "won": 1, "of": 1 },
"loser": { "won": 3, "of": 4 }
},
"double_faults": { "winner": 2, "loser": 1 },
"match_points_saved": { "winner": 0, "loser": 0 },
"return_points_won": {
"winner": { "pct": 30, "won": 9, "of": 30 },
"loser": { "pct": 34, "won": 14, "of": 41 }
},
"return_games_won": {
"winner": { "pct": 17, "won": 1, "of": 6 },
"loser": { "pct": 0, "won": 0, "of": 6 }
},
"service_points_won": {
"winner": { "pct": 66, "won": 27, "of": 41 },
"loser": { "pct": 70, "won": 21, "of": 30 }
},
"service_games_won": {
"winner": { "pct": 100, "won": 6, "of": 6 },
"loser": { "pct": 83, "won": 5, "of": 6 }
},
"total_points_won": {
"winner": { "pct": 51, "won": 36, "of": 71 },
"loser": { "pct": 49, "won": 35, "of": 71 }
},
"total_games_won": {
"winner": { "pct": 58, "won": 7, "of": 12 },
"loser": { "pct": 42, "won": 5, "of": 12 }
}
},
"set_2": {
"first_return_points_won": {
"winner": { "pct": 38, "won": 11, "of": 29 },
"loser": { "pct": 20, "won": 3, "of": 15 }
},
"first_serve_in": {
"winner": { "pct": 56 },
"loser": { "pct": 64 }
},
"first_serve_points_won": {
"winner": { "pct": 80, "won": 12, "of": 15 },
"loser": { "pct": 62, "won": 18, "of": 29 }
},
"second_return_points_won": {
"winner": { "pct": 69, "won": 11, "of": 16 },
"loser": { "pct": 50, "won": 6, "of": 12 }
},
"second_serve_points_won": {
"winner": { "pct": 50, "won": 6, "of": 12 },
"loser": { "pct": 31, "won": 5, "of": 16 }
},
"aces": { "winner": 2, "loser": 8 },
"break_points_won": {
"winner": { "won": 2, "of": 7 },
"loser": { "won": 1, "of": 3 }
},
"break_points_saved": {
"winner": { "won": 2, "of": 3 },
"loser": { "won": 5, "of": 7 }
},
"double_faults": { "winner": 1, "loser": 0 },
"match_points_saved": { "winner": 0, "loser": 1 },
"return_points_won": {
"winner": { "pct": 49, "won": 22, "of": 45 },
"loser": { "pct": 33, "won": 9, "of": 27 }
},
"return_games_won": {
"winner": { "pct": 40, "won": 2, "of": 5 },
"loser": { "pct": 20, "won": 1, "of": 5 }
},
"service_points_won": {
"winner": { "pct": 67, "won": 18, "of": 27 },
"loser": { "pct": 51, "won": 23, "of": 45 }
},
"service_games_won": {
"winner": { "pct": 80, "won": 4, "of": 5 },
"loser": { "pct": 60, "won": 3, "of": 5 }
},
"total_points_won": {
"winner": { "pct": 56, "won": 40, "of": 72 },
"loser": { "pct": 44, "won": 32, "of": 72 }
},
"total_games_won": {
"winner": { "pct": 60, "won": 6, "of": 10 },
"loser": { "pct": 40, "won": 4, "of": 10 }
}
}
},
"service": {
"winner": { "service_games": 11, "held": 10, "break_points_faced": 4, "deuce_games": 4, "broken": 1 },
"loser": { "service_games": 11, "held": 8, "break_points_faced": 11, "deuce_games": 3, "broken": 3 }
}
},
"meta": {}
}{
"error": {
"code": "not_found",
"message": "No match with this id.",
"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 |
|---|---|
id, date, tournament, round, winner, loser, score | The match in short, as in every match answer |
stats | By period (match, set_1, ...): aces, double faults, serve and return points, break points, winners and more, each as winner and loser |
service | For each player: service_games, held, broken, break_points_faced, deuce_games, from the point by point |
duration_minutes, set_minutes | The match length, and each set's, where known |
5Errors
unauthorized | No key, or a key that is unknown or revoked. |
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). |