Skip to content

list_tournaments

1 creditStatic referencePOST /v1/list_tournaments

Data refreshed · changelog

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

Use it when you need tournament ids for a season, or the calendar with surfaces and champions.

Parameters

seasonstring | numberoptional
Year, e.g. 2025 (default this year).
surfaceenum: hard | clay | grass | carpetoptional
Only tournaments on this surface.
statusenum: scheduled | live | finaloptional
Only upcoming, in-progress or completed tournaments.
limitintegeroptional
Max tournaments (default 100).
offsetintegeroptional
Page offset; use next_offset.
leagueenum: tennis | wtaoptional
League. Defaults to tennis. One of: tennis, wta.

Notes

  • Over MCP, ask for it in plain English and the client calls list_tournaments itself. Point any MCP client at https://mcp.acesapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 1 credit, 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/list_tournaments \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2025,
  "surface": "grass",
  "limit": 3
}'

Response

json
{
  "tour": "ATP",
  "season": 2025,
  "tournaments": [
    {
      "tournament_id": "415-2025",
      "espn_tournament_id": 415,
      "name": "Libéma Open",
      "season": 2025,
      "start_date": "2025-06-07",
      "end_date": "2025-06-16",
      "city": "'s-Hertogenbosch",
      "country": "Netherlands",
      "major": false,
      "surface": "grass",
      "indoor": false,
      "status": "final",
      "main_draw_matches": 27,
      "champion": {
        "player_id": "3885",
        "name": "Gabriel Diallo"
      }
    },
    {
      "tournament_id": "49-2025",
      "espn_tournament_id": 49,
      "name": "Boss Open",
      "season": 2025,
      "start_date": "2025-06-07",
      "end_date": "2025-06-16",
      "city": "Stuttgart",
      "country": "Germany",
      "major": false,
      "surface": "grass",
      "indoor": false,
      "status": "final",
      "main_draw_matches": 27,
      "champion": {
        "player_id": "2946",
        "name": "Taylor Fritz"
      }
    },
    {
      "tournament_id": "129-2025",
      "espn_tournament_id": 129,
      "name": "HSBC Championships",
      "season": 2025,
      "start_date": "2025-06-14",
      "end_date": "2025-06-23",
      "city": "London",
      "country": "Great Britain",
      "major": false,
      "surface": "grass",
      "indoor": false,
      "status": "final",
      "main_draw_matches": 31,
      "champion": {
        "player_id": "3782",
        "name": "Carlos Alcaraz"
      }
    }
  ],
  "count": 3,
  "next_offset": 3
}

Response fields

tourstring
seasonnumber
tournaments[]array
List of objects
tournaments[].tournament_idstring
tournaments[].espn_tournament_idnumber
tournaments[].namestring
tournaments[].seasonnumber
tournaments[].start_datestring
tournaments[].end_datestring
tournaments[].citystring
tournaments[].countrystring
tournaments[].majorboolean
tournaments[].surfacestring
tournaments[].indoorboolean
tournaments[].statusstring
tournaments[].main_draw_matchesnumber
tournaments[].championobject
tournaments[].champion.player_idstring
tournaments[].champion.namestring
countnumber
next_offsetnumber

Used in

  • Tennis results data: Every ATP and WTA singles match since 2007, with every set's games and tiebreak points, seeds, rounds and draws. REST or MCP.

Related endpoints

Try it

500 free credits every month: 500 calls to list_tournaments, and no card.