Advanced Tournaments APIs | Tennis API Documentation

Get Tournament Draws

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}/{year}/draws

Returns the full draw structure for a tournament in a given year.

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`{year}`Required	integer
Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad/2026/draws?includeAll=true' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

{
  "singles": [],
  "qualifying": [],
  "doubles": []
}

Get Tournament Seeds

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}/{year}/seeds

Returns the current seedings for a tournament (omit year for current edition)

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`{year}`Required	integer
Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad/2026/seeds?includeAll=true' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

[
  {
    "player": "Alexander Bublik",
    "seed": 1
  }
]

Get Tournament Available Years

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}

Returns all years for which data is available for a tournament

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

[
  {
    "year": 2023,
    "tournamentName": "EFG Swiss Open - Gstaad"
  },
  {
    "year": 2024,
    "tournamentName": "EFG Swiss Open - Gstaad"
  },
  {
    "year": 2025,
    "tournamentName": "EFG Swiss Open - Gstaad"
  },
  {
    "year": 2026,
    "tournamentName": "EFG Swiss Open - Gstaad"
  }
]

Get Tournament Most Victories

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}/most-victories

Returns the list of players with the most wins at a given tournament across all years

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad/most-victories' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

[
  {
    "id": 11,
    "name": "Alex Corretja",
    "countryAcr": "ESP",
    "wins": 3,
    "image": "/tennis/api2/uploads/Photo/atp/00011.jpg",
    "image_p_name": "/tennis/api2/uploads/Photo/atp_name/alex_corretja.jpg"
  }
]

Get Tournament Current Seeds

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}/seeds

Returns the current seedings for a tournament (omit year for current edition)

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad/seeds' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

[
  {
    "player": "Alexander Bublik",
    "seed": 1
  }
]

Get Tournament Details By Year

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}/{year}

Returns general tournament info (surface, level, prize money, dates) for a specific year

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`{year}`Required	integer
Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad/2026' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

{
  "id": 21340,
  "name": "EFG Swiss Open - Gstaad",
  "date": "2026-07-13T00:00:00.000Z",
  "prize": "612K",
  "court": {
    "id": 2,
    "name": "Clay"
  },
  "rank": {
    "id": 2,
    "name": "Main tour"
  },
  "country": {
    "name": "Switzerland",
    "acronym": "SUI"
  }
}

Get Tournament Points Breakdown

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}/{year}/points

Returns the ranking points awarded per round in a given tournament and year.

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`{year}`Required	integer
Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad/2026/points' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

{
  "winner": {
    "points": 250,
    "prize": null
  },
  "finalist": {
    "points": 165,
    "prize": null
  },
  "semiFinalist": {
    "points": 100,
    "prize": null
  },
  "quarterFinalist": {
    "points": 50,
    "prize": null
  },
  "fourth": {
    "points": null,
    "prize": null
  },
  "third": {
    "points": null,
    "prize": null
  },
  "second": {
    "points": 25,
    "prize": null
  },
  "first": {
    "points": null,
    "prize": null
  },
  "qualifying": {
    "points": 13,
    "prize": null
  },
  "qualifyingSecond": {
    "points": 7,
    "prize": null
  },
  "qualifyingFirst": {
    "points": null,
    "prize": null
  },
  "preQualifying": {
    "points": null,
    "prize": null
  }
}

Get Tournament Past Champions

GET/tennis/v2/ms-api/tournament/{tourType}/{tournament}/{year}/past-champions

Returns a list of all previous winners up to and including the specified year.

Path Parameter

Parameter	Type
`{tourType}`Required	string
ENUM("atp", "wta")
`{tournament}`Required	string
Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`{year}`Required	integer
Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/EFG%20Swiss%20Open%20-%20Gstaad/2026/past-champions' \
	--header 'x-rapidapi-host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example Response: JSON

{
  "singlesChampions": [
    {
      "roundId": 12,
      "result": "6-4 4-6 6-3",
      "date": "2025-07-20T00:00:00.000Z",
      "player1Id": 24245,
      "player2Id": 52934,
      "tournamentId": 20351,
      "draw": 1,
      "winner_entry": null,
      "winner_hand": null,
      "winner_ht": null,
      "winner_ioc": null,
      "winner_age": null,
      "loser_entry": null,
      "loser_hand": null,
      "loser_ht": null,
      "loser_ioc": null,
      "loser_age": null,
      "best_of": null,
      "poll_vote": "400",
      "player1": {
        "id": 24245,
        "name": "Alexander Bublik",
        "countryAcr": "KAZ",
        "seed": "2",
        "odd": null,
        "image": "/tennis/api2/uploads/Photo/atp/24245.jpg",
        "image_p_name": "/tennis/api2/uploads/Photo/atp_name/alexander_bublik.jpg",
        "stats": {
          "firstServe": 62,
          "firstServeOf": 94,
          "aces": 13,
          "doubleFaults": 4,
          "unforcedErrors": null,
          "winningOnFirstServe": 50,
          "winningOnFirstServeOf": 62,
          "winningOnSecondServe": 11,
          "winningOnSecondServeOf": 32,
          "winners": null,
          "breakPointsConverted": 4,
          "breakPointsConvertedOf": 14,
          "netApproaches": null,
          "netApproachesOf": null,
          "totalPointsWon": 104,
          "fastestServe": null,
          "averageFirstServeSpeed": null,
          "averageSecondServeSpeed": null
        }
      },
      "player2": {
        "id": 52934,
        "name": "Juan Manuel Cerundolo",
        "countryAcr": "ARG",
        "seed": null,
        "odd": null,
        "image": "/tennis/api2/uploads/Photo/atp/52934.jpg",
        "image_p_name": "/tennis/api2/uploads/Photo/atp_name/juan_manuel_cerundolo.jpg",
        "stats": {
          "firstServe": 73,
          "firstServeOf": 100,
          "aces": 1,
          "doubleFaults": 2,
          "unforcedErrors": null,
          "winningOnFirstServe": 44,
          "winningOnFirstServeOf": 73,
          "winningOnSecondServe": 13,
          "winningOnSecondServeOf": 27,
          "winners": null,
          "breakPointsConverted": 3,
          "breakPointsConvertedOf": 10,
          "netApproaches": null,
          "netApproachesOf": null,
          "totalPointsWon": 90,
          "fastestServe": null,
          "averageFirstServeSpeed": null,
          "averageSecondServeSpeed": null
        }
      },
      "tournament": {
        "id": 20351,
        "name": "EFG Swiss Open - Gstaad",
        "date": "2025-07-14T00:00:00.000Z"
      },
      "h2h": "1-0"
    }
  ],
  "doublesChampions": [
    {
      "roundId": 12,
      "result": "6-7(4) 7-6(4) 10-3",
      "date": "2025-07-20T00:00:00.000Z",
      "player1Id": 118495,
      "player2Id": 118293,
      "tournamentId": 20351,
      "draw": 1,
      "winner_entry": null,
      "winner_hand": null,
      "winner_ht": null,
      "winner_ioc": null,
      "winner_age": null,
      "loser_entry": null,
      "loser_hand": null,
      "loser_ht": null,
      "loser_ioc": null,
      "loser_age": null,
      "best_of": null,
      "poll_vote": "300",
      "player1": {
        "id": 118495,
        "name": "Francisco Cabral/Lucas Miedler",
        "countryAcr": "N/A",
        "seed": "1",
        "odd": 1.6,
        "image": "/tennis/api2/uploads/Photo/atp/18495.jpg",
        "image_p_name": "/tennis/api2/uploads/Photo/atp_name/francisco_cabral/lucas_miedler.jpg",
        "stats": {
          "firstServe": 51,
          "firstServeOf": 81,
          "aces": 9,
          "doubleFaults": 3,
          "unforcedErrors": null,
          "winningOnFirstServe": 42,
          "winningOnFirstServeOf": 51,
          "winningOnSecondServe": 18,
          "winningOnSecondServeOf": 30,
          "winners": null,
          "breakPointsConverted": 0,
          "breakPointsConvertedOf": 4,
          "netApproaches": null,
          "netApproachesOf": null,
          "totalPointsWon": 81,
          "fastestServe": null,
          "averageFirstServeSpeed": null,
          "averageSecondServeSpeed": null
        }
      },
      "player2": {
        "id": 118293,
        "name": "Hendrik Jebens/Albano Olivetti",
        "countryAcr": "N/A",
        "seed": "3",
        "odd": "2.22",
        "image": "/tennis/api2/uploads/Photo/atp/18293.jpg",
        "image_p_name": "/tennis/api2/uploads/Photo/atp_name/hendrik_jebens/albano_olivetti.jpg",
        "stats": {
          "firstServe": 41,
          "firstServeOf": 78,
          "aces": 9,
          "doubleFaults": 3,
          "unforcedErrors": null,
          "winningOnFirstServe": 32,
          "winningOnFirstServeOf": 41,
          "winningOnSecondServe": 25,
          "winningOnSecondServeOf": 37,
          "winners": null,
          "breakPointsConverted": 0,
          "breakPointsConvertedOf": 2,
          "netApproaches": null,
          "netApproachesOf": null,
          "totalPointsWon": 78,
          "fastestServe": null,
          "averageFirstServeSpeed": null,
          "averageSecondServeSpeed": null
        }
      },
      "tournament": {
        "id": 20351,
        "name": "EFG Swiss Open - Gstaad",
        "date": "2025-07-14T00:00:00.000Z"
      }
    }
  ]
}