tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsMatchesMatch statistics
Matches

Match statistics

MCP tool match_statistics
GEThttps://api.tennisdatabaseapi.com/v1/matches/{id}/statisticsEvery plan

Serve 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

NameInTypeWhat it is
idrequiredpathidAn 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"

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": {}
}

Real answers from the API, made 2026-11-18. Long lists are cut to three items here.

4Fields

FieldTypeWhat it holds
id, date, tournament, round, winner, loser, scoremixedThe match in short, as in every match answer
statsobjectBy period (match, set_1, ...): aces, double faults, serve and return points, break points, winners and more, each as winner and loser
serviceobjectFor each player: service_games, held, broken, break_points_faced, deuce_games, from the point by point
duration_minutes, set_minutesintegerThe match length, and each set's, where known

5Errors

401unauthorizedNo key, or a key that is unknown or revoked.
404not_foundNo such id.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).