Skip to content
AcesAPI

get_tournament

2 creditsBasic lookupPOST /v1/get_tournament

A tournament's draw and results, round by round, with every set

Use it when you want a tournament's draw and every result in it, round by round, with seeds and the champion.

Parameters

tournament_idstringrequired
Tournament edition id from list_tournaments, e.g. "188-2025".
drawenum: main | qualifying | alloptional
Which draw (default main).

Notes

  • Over MCP, ask for it in plain English and the client calls get_tournament itself. Point any MCP client at https://mcp.acesapi.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.acesapi.com/v1/get_tournament \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "tournament_id": "188-2025"
}'

Response

json
{
  "tour": "ATP",
  "tournament": {
    "tournament_id": "188-2025",
    "espn_tournament_id": 188,
    "name": "Wimbledon",
    "season": 2025,
    "start_date": "2025-06-23",
    "end_date": "2025-07-14",
    "city": "London",
    "country": "Great Britain",
    "major": true,
    "surface": "grass",
    "indoor": false,
    "status": "final"
  },
  "champion": {
    "player_id": "3623",
    "name": "Jannik Sinner"
  },
  "runner_up": {
    "player_id": "3782",
    "name": "Carlos Alcaraz"
  },
  "rounds": [
    {
      "round": "Round 1",
      "round_order": 11,
      "draw": "main",
      "matches": [
        {
          "match_id": "157674",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-06-30T10:05:00.000Z",
          "match_date": "2025-06-30",
          "draw": "main",
          "round": "Round 1",
          "round_order": 11,
          "court": "Court 4",
          "player1_id": "16614",
          "player1": "Oliver Tarvet",
          "player1_country": "GBR",
          "seed1": null,
          "player2_id": "8243",
          "player2": "Leandro Riedi",
          "player2_country": "SUI",
          "seed2": null,
          "winner_id": "16614",
          "status": "final",
          "outcome": "completed",
          "score": "6-4 6-4 6-4",
          "sets1": 3,
          "sets2": 0,
          "games1": 18,
          "games2": 12,
          "sets": "[3 items]"
        },
        {
          "match_id": "157651",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-06-30T10:10:00.000Z",
          "match_date": "2025-06-30",
          "draw": "main",
          "round": "Round 1",
          "round_order": 11,
          "court": "Court 5",
          "player1_id": "1266",
          "player1": "Adrian Mannarino",
          "player1_country": "FRA",
          "seed1": null,
          "player2_id": "3301",
          "player2": "Christopher O'Connell",
          "player2_country": "AUS",
          "seed2": null,
          "winner_id": "1266",
          "status": "final",
          "outcome": "completed",
          "score": "6-2 6-4 6-3",
          "sets1": 3,
          "sets2": 0,
          "games1": 18,
          "games2": 9,
          "sets": "[3 items]"
        },
        {
          "match_id": "157690",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-06-30T10:10:00.000Z",
          "match_date": "2025-06-30",
          "draw": "main",
          "round": "Round 1",
          "round_order": 11,
          "court": "Court 9",
          "player1_id": "3809",
          "player1": "Vit Kopriva",
          "player1_country": "CZE",
          "seed1": null,
          "player2_id": "2244",
          "player2": "Jordan Thompson",
          "player2_country": "AUS",
          "seed2": null,
          "winner_id": "2244",
          "status": "final",
          "outcome": "completed",
          "score": "3-6 4-6 6-3 7-6(1) 6-1",
          "sets1": 2,
          "sets2": 3,
          "games1": 22,
          "games2": 26,
          "sets": "[5 items]"
        }
      ]
    },
    {
      "round": "Round 2",
      "round_order": 12,
      "draw": "main",
      "matches": [
        {
          "match_id": "157743",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-07-02T12:05:00.000Z",
          "match_date": "2025-07-02",
          "draw": "main",
          "round": "Round 2",
          "round_order": 12,
          "court": "Court 12",
          "player1_id": "11745",
          "player1": "Joao Fonseca",
          "player1_country": "BRA",
          "seed1": null,
          "player2_id": "3621",
          "player2": "Jenson Brooksby",
          "player2_country": "USA",
          "seed2": null,
          "winner_id": "11745",
          "status": "final",
          "outcome": "completed",
          "score": "6-4 5-7 6-2 6-4",
          "sets1": 3,
          "sets2": 1,
          "games1": 23,
          "games2": 17,
          "sets": "[4 items]"
        },
        {
          "match_id": "157712",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-07-02T12:10:00.000Z",
          "match_date": "2025-07-02",
          "draw": "main",
          "round": "Round 2",
          "round_order": 12,
          "court": "No. 1 Court",
          "player1_id": "2366",
          "player1": "Cameron Norrie",
          "player1_country": "GBR",
          "seed1": null,
          "player2_id": "2708",
          "player2": "Frances Tiafoe",
          "player2_country": "USA",
          "seed2": 12,
          "winner_id": "2366",
          "status": "final",
          "outcome": "completed",
          "score": "4-6 6-4 6-3 7-5",
          "sets1": 3,
          "sets2": 1,
          "games1": 23,
          "games2": 18,
          "sets": "[4 items]"
        },
        {
          "match_id": "157716",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-07-02T12:20:00.000Z",
          "match_date": "2025-07-02",
          "draw": "main",
          "round": "Round 2",
          "round_order": 12,
          "court": "Court 16",
          "player1_id": "1266",
          "player1": "Adrian Mannarino",
          "player1_country": "FRA",
          "seed1": null,
          "player2_id": "4022",
          "player2": "Valentin Royer",
          "player2_country": "FRA",
          "seed2": null,
          "winner_id": "1266",
          "status": "final",
          "outcome": "completed",
          "score": "6-4 6-4 5-7 7-6(1)",
          "sets1": 3,
          "sets2": 1,
          "games1": 24,
          "games2": 21,
          "sets": "[4 items]"
        }
      ]
    },
    {
      "round": "Round 3",
      "round_order": 13,
      "draw": "main",
      "matches": [
        {
          "match_id": "157744",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-07-04T12:35:00.000Z",
          "match_date": "2025-07-04",
          "draw": "main",
          "round": "Round 3",
          "round_order": 13,
          "court": "Centre Court",
          "player1_id": "2946",
          "player1": "Taylor Fritz",
          "player1_country": "USA",
          "seed1": 5,
          "player2_id": "3212",
          "player2": "Alejandro Davidovich Fokina",
          "player2_country": "ESP",
          "seed2": 26,
          "winner_id": "2946",
          "status": "final",
          "outcome": "completed",
          "score": "6-4 6-3 6-7(5) 6-1",
          "sets1": 3,
          "sets2": 1,
          "games1": 24,
          "games2": 15,
          "sets": "[4 items]"
        },
        {
          "match_id": "157750",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-07-04T12:40:00.000Z",
          "match_date": "2025-07-04",
          "draw": "main",
          "round": "Round 3",
          "round_order": 13,
          "court": "No. 3 Court",
          "player1_id": "2642",
          "player1": "Andrey Rublev",
          "player1_country": "RUS",
          "seed1": 14,
          "player2_id": "1266",
          "player2": "Adrian Mannarino",
          "player2_country": "FRA",
          "seed2": null,
          "winner_id": "2642",
          "status": "final",
          "outcome": "completed",
          "score": "7-5 6-2 6-3",
          "sets1": 3,
          "sets2": 0,
          "games1": 19,
          "games2": 10,
          "sets": "[3 items]"
        },
        {
          "match_id": "157757",
          "tournament_id": "188-2025",
          "tournament": "Wimbledon",
          "season": 2025,
          "surface": "grass",
          "indoor": false,
          "starts_at": "2025-07-04T13:55:00.000Z",
          "match_date": "2025-07-04",
          "draw": "main",
          "round": "Round 3",
          "round_order": 13,
          "court": "No. 1 Court",
          "player1_id": "10153",
          "player1": "Mattia Bellucci",
          "player1_country": "ITA",
          "seed1": null,
          "player2_id": "2366",
          "player2": "Cameron Norrie",
          "player2_country": "GBR",
          "seed2": null,
          "winner_id": "2366",
          "status": "final",
          "outcome": "completed",
          "score": "7-6(5) 6-4 6-3",
          "sets1": 0,
          "sets2": 3,
          "games1": 13,
          "games2": 19,
          "sets": "[3 items]"
        }
      ]
    }
  ],
  "count": 127
}

Response fields

tourstring
tournamentobject
tournament.tournament_idstring
tournament.espn_tournament_idnumber
tournament.namestring
tournament.seasonnumber
tournament.start_datestring
tournament.end_datestring
tournament.citystring
tournament.countrystring
tournament.majorboolean
tournament.surfacestring
tournament.indoorboolean
tournament.statusstring
championobject
champion.player_idstring
champion.namestring
runner_upobject
runner_up.player_idstring
runner_up.namestring
rounds[]array
List of objects
rounds[].roundstring
rounds[].round_ordernumber
rounds[].drawstring
rounds[].matches[]array
List of objects
rounds[].matches[].match_idstring
rounds[].matches[].tournament_idstring
rounds[].matches[].tournamentstring
rounds[].matches[].seasonnumber
rounds[].matches[].surfacestring
rounds[].matches[].indoorboolean
rounds[].matches[].starts_atstring
rounds[].matches[].match_datestring
rounds[].matches[].drawstring
rounds[].matches[].roundstring
rounds[].matches[].round_ordernumber
rounds[].matches[].courtstring
rounds[].matches[].player1_idstring
rounds[].matches[].player1string
rounds[].matches[].player1_countrystring

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

get_matches2 cr

Filters by the same tournament_id.

Match results by day, tournament or season, with set and tiebreak scores

list_tournaments1 cr

Also static reference.

A season's tournaments with dates, surface, status and champion

Try it

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

Get a free keyAll ATP endpoints