GET
https://api.tennisdatabaseapi.com/v1/matches/{id}/pointsEvery planEvery game and point of a match: who served, who won it, breaks, break points and set points.
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/points
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/points"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213/points'); 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/points", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213/points", { 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",
"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_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",
"summary": {
"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 }
},
"games": [
{
"set": 1,
"game": 1,
"tiebreak": false,
"server": "loser",
"won_by": "loser",
"break": false,
"games_after": { "winner": 0, "loser": 1 },
"points": ["0-15", "0-30", "0-40", "15-40"],
"break_points": [],
"set_points": []
},
{
"set": 1,
"game": 2,
"tiebreak": false,
"server": "winner",
"won_by": "winner",
"break": false,
"games_after": { "winner": 1, "loser": 1 },
"points": ["15-0", "30-0", "30-15", "40-15", "40-30"],
"break_points": [],
"set_points": []
},
{
"set": 1,
"game": 3,
"tiebreak": false,
"server": "loser",
"won_by": "loser",
"break": false,
"games_after": { "winner": 1, "loser": 2 },
"points": ["0-15", "0-30", "0-40"],
"break_points": [],
"set_points": []
},
"..."
]
},
"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 |
summary | Holds, breaks, break points faced and deuce games for each player |
games | Every game in order: set, game, tiebreak, server, won_by, break, games_after, points (winner first), break_points, set_points. A tie-break is one game with tiebreak true: its points are the running tie-break score, winner first like every other game (1-0, 2-0 ... 7-1), its server the player who served the first point, and a point won against the serve inside it is not counted as a break |
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). |