Advanced API

Tournament Advanced

This module covers three sub-areas: detailed tournament data (draws, points, seeds, past champions), the calendar (season schedule, grand slam history), and potential fixtures (who could play who this week).

Tournament

ℹ️

Base path: /tennis/v2/ms-api/tournament/{type}/...

Endpoint Summary

Method	Path	Description
GET	`.../tournament/{type}/{name}`	Available years for a tournament
GET	`.../tournament/{type}/{name}/{year}`	Tournament details for a specific year
GET	`.../tournament/{type}/{name}/most-victories`	Players with most victories
GET	`.../tournament/{type}/{name}/{year}/points`	Points breakdown
GET	`.../tournament/{type}/{name}/{year}/draws`	Draw structure
GET	`.../tournament/{type}/{name}/{year}/past-champions`	Past champions
GET	`.../tournament/{type}/{name}/{year}/seeds`	Seeds for a specific year
GET	`.../tournament/{type}/{name}/seeds`	Current seeds

Tournament Draws

GET /tennis/v2/ms-api/tournament/{type}/{name}/{year}/draws Returns the full draw structure for a tournament in a given year

Path Parameters

Parameter	Type	Description
`type` Required	string	`atp` or `wta`
`name` Required	string	Tournament name slug, e.g. `wimbledon`, `roland-garros`
`year` Required	number	4-digit year, e.g. `2024`

Query Parameters

Parameter	Type	Description
`includeAll` Optional	boolean	Include all draw rounds

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/wimbledon/2024/draws' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

{
  "tournament": "Wimbledon",
  "year": 2024,
  "surface": "Grass",
  "rounds": [
    {
      "round": "Final",
      "matches": [
        {
          "player1": "Carlos Alcaraz",
          "player2": "Novak Djokovic",
          "winner": "Carlos Alcaraz",
          "score": "6-2 6-2 7-6"
        }
      ]
    }
  ]
}

Response Properties

Property	Type	Description
`tournament`	string	Tournament name
`year`	integer	Season year
`surface`	string	Court surface
`rounds`	array	Array of draw rounds
`rounds[].round`	string	Round name, e.g. `"Final"`, `"Semi-Final"`
`rounds[].matches`	array	Matches in that round — each has `player1`, `player2`, `winner`, and `score`

Most Victories

GET /tennis/v2/ms-api/tournament/{type}/{name}/most-victories Returns the list of players with the most wins at a given tournament across all years

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/roland-garros/most-victories' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

[
  {
    "player": "Rafael Nadal",
    "slug": "nadal-rafael",
    "titles": 14,
    "years": [2005, 2006, 2007, "..."]
  },
  {
    "player": "Novak Djokovic",
    "slug": "djokovic-novak",
    "titles": 3,
    "years": [2016, 2021, 2023]
  }
]

Response Properties

Property	Type	Description
`player`	string	Player display name
`slug`	string	Player slug
`titles`	integer	Number of times this player has won the tournament
`years`	array of integer	List of years in which they won

Available Years

GET /tennis/v2/ms-api/tournament/{type}/{name} Returns all years for which data is available for a tournament

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/wimbledon' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

{
  "tournament": "Wimbledon",
  "years": [2025, 2024, 2023, 2022]
}

Response Properties

Property	Type	Description
`tournament`	string	Tournament display name
`years`	array<integer>	Years with available data, newest first

Tournament Details by Year

GET /tennis/v2/ms-api/tournament/{type}/{name}/{year} Returns general tournament info (surface, level, prize money, dates) for a specific year

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/wimbledon/2024' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

{
  "tournament": "Wimbledon",
  "year": 2024,
  "surface": "Grass",
  "level": "Grand Slam",
  "startDate": "2024-07-01",
  "endDate": "2024-07-14",
  "winner": "Carlos Alcaraz"
}

Response Properties

Property	Type	Description
`tournament`	string	Tournament display name
`year`	integer	Edition year
`surface`	string	Court surface
`level`	string	Tournament category (e.g. `"Grand Slam"`, `"Masters"`)
`startDate` / `endDate`	string	Tournament date range
`winner`	string	Winner display name

Points Breakdown

GET /tennis/v2/ms-api/tournament/{type}/{name}/{year}/points Returns the ranking points awarded per round in a given tournament and year

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/wimbledon/2024/points' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

{
  "winner": {
    "points": null,
    "prize": null
  },
  "finalist": {
    "points": null,
    "prize": null
  },
  "semiFinalist": {
    "points": null,
    "prize": null
  },
  "quarterFinalist": {
    "points": null,
    "prize": null
  },
  "first": {
    "points": null,
    "prize": null
  },
  "qualifying": {
    "points": null,
    "prize": null
  }
}

Response Properties

Property	Type	Description
`winner`	object	Winner points and prize
`winner.points`	number \| null	Ranking points for winner
`winner.prize`	number \| null	Prize money for winner
`finalist`	object	Finalist points and prize
`semiFinalist`	object	Semi-finalist points and prize
`quarterFinalist`	object	Quarter-finalist points and prize
`first`	object	First round points and prize
`qualifying`	object	Qualifying round points and prize

Past Champions

GET /tennis/v2/ms-api/tournament/{type}/{name}/{year}/past-champions Returns a list of all previous winners up to and including the specified year

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/wimbledon/2024/past-champions' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

[
  { "year": 2024, "winner": "Carlos Alcaraz", "slug": "alcaraz-carlos" },
  { "year": 2023, "winner": "Carlos Alcaraz", "slug": "alcaraz-carlos" },
  { "year": 2022, "winner": "Novak Djokovic", "slug": "djokovic-novak" }
]

Response Properties

Property	Type	Description
`year`	integer	Tournament year
`winner`	string	Champion display name
`slug`	string	Champion player slug

Tournament Seeds

GET /tennis/v2/ms-api/tournament/{type}/{name}/seeds Returns the current seedings for a tournament (omit year for current edition)

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/tournament/atp/wimbledon/seeds' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

[
  { "seed": 1, "player": "Jannik Sinner", "slug": "sinner-jannik" },
  { "seed": 2, "player": "Carlos Alcaraz", "slug": "alcaraz-carlos" }
]

Response Properties

Property	Type	Description
`seed`	integer	Seeding number
`player`	string	Player display name
`slug`	string	Player slug

Calendar

ℹ️

Base path: /tennis/v2/ms-api/calendar/{type}/...

Method	Path	Description
GET	`.../calendar/{type}/{year}`	Full season calendar for a year
GET	`.../calendar/{type}/filters`	Calendar filter options
GET	`.../calendar/{type}/grand-slam-champions`	All-time Grand Slam champions

Season Calendar

GET /tennis/v2/ms-api/calendar/{type}/{year} Returns all tournaments on the season calendar for a given year and tour

Path Parameters

Parameter	Type	Description
`type` Required	string	`atp` or `wta`
`year` Required	number	4-digit year, e.g. `2025`

Query Parameters

Parameter	Type	Description
`level` Optional	string	Filter by tournament level, e.g. `Grand Slam`, `Masters`
`sortOrder` Optional	string	`ASC` or `DESC`

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/calendar/atp/2025?level=Grand%20Slam' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

[
  {
    "name": "Australian Open",
    "slug": "australian-open",
    "level": "Grand Slam",
    "surface": "Hard",
    "location": "Melbourne, Australia",
    "startDate": "2025-01-13",
    "endDate": "2025-01-26"
  }
]

Response Properties

Property	Type	Description
`name`	string	Full tournament name
`slug`	string	Tournament slug used in other tournament endpoints
`level`	string	Tournament tier, e.g. `"Grand Slam"`, `"Masters 1000"`, `"ATP 500"`
`surface`	string	Court surface
`location`	string	City and country
`startDate`	string	Tournament start date in `YYYY-MM-DD`
`endDate`	string	Tournament end date in `YYYY-MM-DD`

Grand Slam Champions

GET /tennis/v2/ms-api/calendar/{type}/grand-slam-champions Returns the full list of all-time Grand Slam champions for the specified tour

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/calendar/atp/grand-slam-champions' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

[
  {
    "tournament": "Wimbledon",
    "year": 2024,
    "champion": "Carlos Alcaraz",
    "slug": "alcaraz-carlos",
    "runnerUp": "Novak Djokovic",
    "score": "6-2 6-2 7-6"
  }
]

Response Properties

Property	Type	Description
`tournament`	string	Grand Slam name
`year`	integer	Year of the championship
`champion`	string	Winner's display name
`slug`	string	Winner's player slug
`runnerUp`	string	Runner-up's display name
`score`	string	Final score string

Potential Fixtures

ℹ️

Base path: /tennis/v2/ms-api/potential-fixtures/{type}/...

Method	Path	Description
GET	`.../potential-fixtures/{type}`	All potential fixtures this week
GET	`.../potential-fixtures/{type}/active-players`	Players active this week
GET	`.../potential-fixtures/{type}/player/{player}`	Potential fixtures for a specific player
GET	`.../potential-fixtures/{type}/tournament/{tournament}`	Potential fixtures for a specific tournament

All Potential Fixtures

GET /tennis/v2/ms-api/potential-fixtures/{type} Returns all possible match combinations among active players this week

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/potential-fixtures/atp' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

[
  {
    "player1": "Carlos Alcaraz",
    "player1Slug": "alcaraz-carlos",
    "player2": "Jannik Sinner",
    "player2Slug": "sinner-jannik",
    "tournament": "Wimbledon",
    "possibleRound": "Semi-Final",
    "h2hPlayer1Wins": 3,
    "h2hPlayer2Wins": 5
  }
]

Response Properties

Property	Type	Description
`player1` / `player2`	string	Display names of the two players who could potentially meet
`player1Slug` / `player2Slug`	string	Player slugs — use in Profile or H2H endpoints for deeper data
`tournament`	string	Tournament name where this fixture could occur
`possibleRound`	string	The earliest round in which these two players could meet based on the draw
`h2hPlayer1Wins` / `h2hPlayer2Wins`	integer	All-time H2H win counts for each player

Active Players This Week

GET /tennis/v2/ms-api/potential-fixtures/{type}/active-players Returns the list of players currently entered in an active tournament this week

Example Request

cURL

curl --request GET \
  --url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/ms-api/potential-fixtures/atp/active-players' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com'

Example Response

JSON

[
  {
    "name": "Carlos Alcaraz",
    "slug": "alcaraz-carlos",
    "currentRank": 3,
    "tournament": "Wimbledon",
    "seed": 3
  }
]

Response Properties

Property	Type	Description
`name`	string	Player display name
`slug`	string	Player slug
`currentRank`	integer \| null	Current world ranking
`tournament`	string	The active tournament they are entered in this week
`seed`	integer \| null	Their seeding in this tournament, or `null` if unseeded