API Reference

Tournaments

The Tournaments module provides tournament metadata, season history, past champions, results, and a full year calendar for ATP and WTA events.

ℹ️

Season IDs vs Tournament IDs

Each row in the database represents a single year-edition of an event (a "season"). Wimbledon 2024 and Wimbledon 2025 are separate rows, each with their own id (the seasonid). All year-editions of the same event are linked together via the link field. Use the Calendar endpoint to discover seasonid values for a given year.

Endpoint Summary

GET/tennis/v2/{tour_type}/tournament/calendar/{year}

GET/tennis/v2/{tour_type}/tournament/info/{season_id}

GET/tennis/v2/{tour_type}/tournament/seasons/{season_id}

GET/tennis/v2/{tour_type}/tournament/past-champtions/{season_id}

GET/tennis/v2/{tour_type}/tournament/results/{season_id}

Get Tournament Calendar

GET/tennis/v2/{tour_type}/tournament/calendar/{year}

Returns all tournaments scheduled in a given calendar year.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`year`	Yes	Year Value(2026)

Query Parameter

Parameter	Required	Description
`include`	No	Comma-separated extras to load. `court`, `rank`, and `country` are always included by default. Additional available options: `rating` — ranking points awarded per round (winner, finalist, SF, QF, etc.) `singlesPrize` — prize money per round in USD (ATP only) Example: `include=rating,singlesPrize`
`filter`	No	Semicolon-separated filters in `Key:value` format. Available filters: `TourRank:1, 2` — filter by tournament tier ID(s) (1=Grand Slam, 2=Masters, 3=500, 4=250) `TourCourt:1, 2` — filter by court surface ID(s) Example: `filter=TourRank:1,2;TourCourt:2`
`since`	No	ISO date string (`YYYY-MM-DD`). When provided, only returns tournaments starting on or after this date. Useful for listing active or upcoming tournaments. Example: `since=2025-05-01`
`pageSize`	No	Results per page. Default: `10`. Use `pageSize=20,00` to retrieve the full year in a single call (ATP has ~950 tournaments per year including ITF/Challenger events).
`pageNo`	No	Page number, 1-indexed. Default: `1`. Example: pageNo=1. Use `hasNextPage` in the response to check for more pages.

Example Request: CURL

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

Get Tournament Info

GET/tennis/v2/{tour_type}/tournament/info/{season_id}

Returns detailed information for a specific tournament season, including prize money and ranking points per round.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`season_id`	Yes	Tournament season ID (≥ 1). Non-numeric or zero IDs return `400 Bad Request`. Invalid IDs return `404 Not Found`.

Query Parameter

Parameter	Required	Description
`include`	No	Comma-separated extras to load. `court`, `rank`, and `country` are always included by default. Additional available options: `rating` — ranking points per round (winner, finalist, SF, QF, R16, R32, R64, qualifying) `singlesPrize` — USD prize money per round (ATP only) Example: `include=rating,singlesPrize`

Example Request: CURL

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

Get Tournament Seasons

GET/tennis/v2/{tour_type}/tournament/seasons/{season_id}

Returns all yearly editions (seasons) of the same tournament event.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`season_id`	Yes	Tournament season ID (≥ 1). Non-numeric or zero IDs return `400 Bad Request`. Invalid IDs return `404 Not Found`.

Example Request: CURL

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

Get Tournament Past Champions

GET/tennis/v2/{tour_type}/tournament/past-champtions/{season_id}

Returns a list of past winners (champions) for a recurring tournament.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`season_id`	Yes	Tournament season ID (≥ 1). Non-numeric or zero IDs return `400 Bad Request`. Invalid IDs return `404 Not Found`.

Example Request: CURL

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

Get Tournament Results

GET/tennis/v2/{tour_type}/tournament/results/{season_id}

Returns the full match results draw for a tournament season.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`season_id`	Yes	Tournament season ID (≥ 1). Non-numeric or zero IDs return `400 Bad Request`. Invalid IDs return `404 Not Found`.

Example Request: CURL

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

Results are from the historical Game archive — player1 is always the winner, player2 is the loser. The result field contains the score string (set scores, e.g. "6-3 6-2 6-4").

Get Tournament Draws

GET/tennis/v2/tournament/{tour_type}/{tournament}/{year}/draws

Returns the complete tournament draw for the selected event, including all rounds, matchups, player information, seeds, scores, and match status. This endpoint can be used to display the tournament bracket from the opening round through the final.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`year`	Yes	Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/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'

Get Tournament Seeds

GET/tennis/v2/tournament/{tour_type}/{tournament}/{year}/seeds

Returns the list of seeded players for a specific tournament. Each record includes the player's name and their official seed number in the tournament draw.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`year`	Yes	Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/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'

Get Tournament Available Years

GET/tennis/v2/tournament/{tour_type}/{tournament}

Returns all available years for which historical data exists for a specific tournament.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	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/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'

Get Tournament Most Victories

GET/tennis/v2/tournament/{tour_type}/{tournament}/most-victories

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

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	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/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'

Get Tournament Current Seeds

GET/tennis/v2/tournament/{tour_type}/{tournament}/seeds

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

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	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/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'

Get Tournament Details By Year

GET/tennis/v2/tournament/{tour_type}/{tournament}/{year}

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

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`year`	Yes	Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/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'

Get Tournament Points Breakdown

GET/tennis/v2/tournament/{tour_type}/{tournament}/{year}/points

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

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`year`	Yes	Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/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'

Get Tournament Past Champions

GET/tennis/v2/tournament/{tour_type}/{tournament}/{year}/past-champions

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

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`tournament`	Yes	Tournament name ("EFG%20Swiss%20Open%20-%20Gstaad")
`year`	Yes	Year Value(2026)

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/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'