Skip to content

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_match itself. Point any MCP client at https://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

tourstring
matchobject
match.match_idstring
match.tournament_idstring
match.tournamentstring
match.seasonnumber
match.surfacestring
match.indoorboolean
match.starts_atstring
match.match_datestring
match.drawstring
match.roundstring
match.round_ordernumber
match.courtstring
match.player1_idstring
match.player1string
match.player1_countrystring
match.seed1number
match.player2_idstring
match.player2string
match.player2_countrystring
match.seed2number
match.winner_idstring
match.statusstring
match.outcomestring
match.scorestring
match.sets1number
match.sets2number
match.games1number
match.games2number
match.notestring
match.sets[]array
List of objects
match.sets[].set_nonumber
match.sets[].games1number
match.sets[].games2number
match.sets[].tiebreak1null
match.sets[].tiebreak2null
match.sets[].winnernumber
players[]array
List of objects
players[].player_idstring

Related endpoints

Try it

500 credits free on signup: 250 calls to get_match, and no card.