get_match
2 creditsBasic lookupPOST /v1/get_match
One match: sets, tiebreak points, seeds, ratings and what the score says
Use it when you need one match in full: every set with tiebreak points, seeds, both ratings before and after, and what the score says.
Parameters
match_idstringrequired- Match id from get_tournament, get_matches or get_player_matches.
Notes
- Over MCP, ask for it in plain English and the client calls
get_matchitself. Point any MCP client athttps://mcp.tiebreakapi.com/mcp?key=YOUR_API_KEY. - Each call costs 2 credits, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.tiebreakapi.com/v1/get_match \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"match_id": "157774"
}'Response
json
{
"tour": "ATP",
"match": {
"match_id": "157774",
"tournament_id": "188-2025",
"tournament": "Wimbledon",
"season": 2025,
"surface": "grass",
"indoor": false,
"starts_at": "2025-07-13T15:20:00.000Z",
"match_date": "2025-07-13",
"draw": "main",
"round": "Final",
"round_order": 22,
"court": "Centre Court",
"player1_id": "3623",
"player1": "Jannik Sinner",
"player1_country": "ITA",
"seed1": 1,
"player2_id": "3782",
"player2": "Carlos Alcaraz",
"player2_country": "ESP",
"seed2": 2,
"winner_id": "3623",
"status": "final",
"outcome": "completed",
"score": "4-6 6-4 6-4 6-4",
"sets1": 3,
"sets2": 1,
"games1": 22,
"games2": 18,
"note": "(1) Jannik Sinner (ITA) bt (2) Carlos Alcaraz (ESP) 4-6 6-4 6-4 6-4",
"sets": [
{
"set_no": 1,
"games1": 4,
"games2": 6,
"tiebreak1": null,
"tiebreak2": null,
"winner": 2
},
{
"set_no": 2,
"games1": 6,
"games2": 4,
"tiebreak1": null,
"tiebreak2": null,
"winner": 1
},
{
"set_no": 3,
"games1": 6,
"games2": 4,
"tiebreak1": null,
"tiebreak2": null,
"winner": 1
}
]
},
"players": [
{
"player_id": "3623",
"name": "Jannik Sinner",
"seed": 1,
"sets_won": 3,
"games_won": 22,
"tiebreaks_won": 0,
"tiebreak_points_won": 0,
"sets_won_6_0": 0,
"rating": {
"before": 2325,
"after": 2335,
"surface_before": 1995,
"surface_after": 2037
}
},
{
"player_id": "3782",
"name": "Carlos Alcaraz",
"seed": 2,
"sets_won": 1,
"games_won": 18,
"tiebreaks_won": 0,
"tiebreak_points_won": 0,
"sets_won_6_0": 0,
"rating": {
"before": 2278,
"after": 2267,
"surface_before": 2176,
"surface_after": 2135
}
}
],
"stats": {
"sets_played": 4,
"total_games": 40,
"tiebreaks": 0,
"went_the_distance": false,
"winner_lost_first_set": true,
"serve_stats": null,
"serve_stats_note": "ESPN publishes no serve statistics for tennis (aces, double faults, break points), so none are served here."
},
"odds": []
}Response fields
tourstringmatchobjectmatch.match_idstringmatch.tournament_idstringmatch.tournamentstringmatch.seasonnumbermatch.surfacestringmatch.indoorbooleanmatch.starts_atstringmatch.match_datestringmatch.drawstringmatch.roundstringmatch.round_ordernumbermatch.courtstringmatch.player1_idstringmatch.player1stringmatch.player1_countrystringmatch.seed1numbermatch.player2_idstringmatch.player2stringmatch.player2_countrystringmatch.seed2numbermatch.winner_idstringmatch.statusstringmatch.outcomestringmatch.scorestringmatch.sets1numbermatch.sets2numbermatch.games1numbermatch.games2numbermatch.notestringmatch.sets[]array- List of objects
match.sets[].set_nonumbermatch.sets[].games1numbermatch.sets[].games2numbermatch.sets[].tiebreak1nullmatch.sets[].tiebreak2nullmatch.sets[].winnernumberplayers[]array- List of objects
players[].player_idstring
Related endpoints
get_head_to_head3 cr
Takes the player_id this one returns.
Two players' meetings, wins by surface and in finals
get_surface_splits3 cr
Takes the player_id this one returns.
A player's record by surface: sets, games, tiebreaks, deciding sets
list_tournaments1 cr
Also static reference.
A season's tournaments with dates, surface, status and champion
search_players1 cr
Also static reference.
Find players by name or country
Try it
500 credits free on signup: 250 calls to get_match, and no card.