API Reference

Players

The Players module exposes player profile data, match statistics, surface performance, titles, finals history, past matches, and performance breakdowns for every ATP and WTA player in the database.

Get All Players

GET/tennis/v2/{tour_type}/player

Returns a list of all players in the selected tour. The Player entity serves a dual purpose — it is both a profile record and a live ranking snapshot. Fields are updated whenever ATP/WTA publish their official weekly ranking lists.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Query Parameter

Parameter	Required	Description
`include`	No	Comma-separated relations to load. Available: `country` — adds full country object to each player. Example: `include=country`
`filter`	No	Semicolon-separated filters in `Key:value` format. Available filters: `PlayerGroup:singles` \| `doubles` \| `both` `PlayerCountry:{ESP,ITA}` — filter by 3-letter country acronym Example:`filter=PlayerGroup:singles;PlayerCountry:ESP,ITA`
`pageSize`	No	Results per page. Default: `10`. Example: pageSize=10.
`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/player' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Player Profile

GET/tennis/v2/{tour_type}/player/profile/{player_id}

Returns full profile details for a single player including ranking, surface breakdown, and extended biographical data

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Query Parameter

Parameter	Required	Description
`include`	No	Comma-separated extras to load. Available: `form` — appends recent form as a `form` array (e.g.`["w","l","w"]`) `ranking` — appends `curRank` and `bestRank` objects with ranking history data `country` — appends a full `country` object (name, acronym, flag) to the player Example: `include=form,ranking,country`

Example Request: CURL

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

Get Player Titles

GET/tennis/v2/{tour_type}/player/titles/{player_id}

Returns all tournament titles won by a player

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Example Request: CURL

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

Get Player Match Statistics

GET/tennis/v2/{tour_type}/player/match-stats/{player_id}

Returns aggregated match statistics for a player (win/loss records, ace counts, break point stats, etc.)

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/atp/player/match-stats/68074' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Player Past Matches

GET/tennis/v2/{tour_type}/player/past-matches/{player_id}

Returns completed match results for a player, most recent first.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Query Parameter

Parameter	Required	Description
`include`	No	Comma-separated relations to load. Available: `round`, `tournament`,`tournament.court`, `tournament.rank`, `tournament.country`,`stat` (per-match serve & return stats). Example:`include=round,tournament.court,stat`
`filter`	No	Semicolon-separated filters in `Key:value` format. Available filters: `GameYear:{2024,2025}` — filter by year(s) `GameRound:{1,2}` — filter by round ID(s) `GameCourt:{1,2}` — filter by court ID(s), requires`tournament` in `include` `TourRank:{1,2}` — filter by tournament rank ID(s), requires`tournament` in `include` `GameTour:{20340}` — filter by tournament ID(s) Example: `filter=GameYear:2025;GameRound:1,2`
`pageSize`	No	Results per page. Default: `10`. Example: pageSize=10.
`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/player/past-matches/68074' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Player Surface Summary

GET/tennis/v2/{tour_type}/player/surface-summary/{player_id}

Returns win/loss records broken down by court surface (hard, clay, grass, carpet, indoor hard)

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/atp/player/surface-summary/68074' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Player Performance Breakdown

GET/tennis/v2/{tour_type}/player/perf-breakdown/{player_id}

Returns granular performance metrics including serve, return, and pressure statistics.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/atp/player/perf-breakdown/68074' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Returns { data: {...} } wheredata is a parsed JSON blob stored in the PlayerStat table. The exact field set varies by player and data source. The object typically contains detailed serve/return performance metrics, pressure statistics, and situational win rates — similar in structure to the H2H Stats response. Returns { data: null } if no performance data is available for the player.

Get Player Finals

GET/tennis/v2/{tour_type}/player/finals/{player_id}

Returns all finals appearances (won and lost) for a player.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Query Parameter

Parameter	Required	Description
`filter`	No	Semicolon-separated filters in `Key:value` format. Available filters: `GameYear:{2024,2025}` — filter by year(s) `GameRound:{1,2}` — filter by round ID(s) `GameCourt:{1,2}` — requires `tournament` in`include` `TourRank:{1,2}` — requires `tournament` in`include` `GameTour:{20340}` — filter by tournament ID(s) Example: `filter=GameYear:2024,2025;TourRank:1`

Example Request: CURL

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

Returns { data: [...] } — same match record structure as Past Matches. Only final-round matches are included (roundId = 12 for standard events, roundId = 16 for Tour Finals round-robin). Includes tournament prize field and optional country object for the host nation.

Get Player Interesting H2H

GET/tennis/v2/{tour_type}/player/intersting-h2h/{player_id}

Returns notable head-to-head records for a player (most wins, biggest rivals, etc.)

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/atp/player/intersting-h2h/68074' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Player Filter

GET/tennis/v2/{tour_type}/player/filter/{player_id}

Returns available filter categories and metadata for a player (used to build UI filter panels)

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.

Example Request: CURL

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

Get Player Tournament Record

GET/tennis/v2/{tour_type}/player/tournament-record/{player_id}/{tourId}

Returns a player's career record at a specific tournament, one entry per year.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player_id`	Yes	Player ID (≥ 1). Obtain from the Players module.
`{tourId}`	Yes	Any season ID from the tournament family. All historical editions of the same event are automatically included.

Example Request: CURL

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

Get Profile Data

GET/tennis/v2/profile/{player_id_or_name}

Retrieve detailed information about a tennis player, including personal details, current ranking, career prize money, playing style, coach, nationality, profile images, and available career finals by year.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Example Request: CURL

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

Get Statistics Data

GET/tennis/v2/profile/{player_id_or_name}/statistics

Retrieve a player's comprehensive career statistics, including recent match results, current and highest rankings, performance across tournament categories, overall win/loss record, favorite playing surface, and career titles and finals.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/statistics' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Surface Summary

GET/tennis/v2/profile/{player_id_or_name}/surface-summary

Retrieve a player's year-by-year win/loss record across all court surfaces, including overall results, hard courts, indoor hard courts, clay courts, and grass courts.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/surface-summary' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Played Matches

GET/tennis/v2/profile/{player_id_or_name}/matches-played

Returns paginated match history with opponent names, scores, tournament info, and round.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Query Parameter

Parameter	Required	Description
`surface`	No	Filter by surface: "hard", "clay", "grass" etc, e.g. surface=hard
`year`	No	Filter by seasons year, e.g. year=2026
`limit`	No	Results per page, e.g. limit=20
`page`	No	Page number default: 1, e.g. page=1

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/matches-played' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Finals By Year

GET/tennis/v2/profile/{player_id_or_name}/finals/{year}

Returns all tournament finals the player reached in the given year, with result (won/lost).

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.
`year`	Yes	4-digit season year, e.g. "2024"

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/finals/2024' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Match Stats By Year

GET/tennis/v2/profile/{player_id_or_name}/match-stat/{year}

Retrieve a player's detailed match statistics for a specific season, including service performance, return performance, break point efficiency, total games played, and overall points won.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.
`year`	Yes	4-digit year (e.g. "2024") or "all" for career totals

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/match-stat/2024' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Player Status

GET/tennis/v2/profile/{player_id_or_name}/player-status

Retrieve the current status of a tennis player, such as whether they are Active or Inactive.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/player-status' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Breakdown Performance

GET/tennis/v2/profile/{player_id_or_name}/breakdown

Returns win/loss records broken down by round, tournament level, and opponent ranking range.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Query Parameter

Parameter	Required	Description
`includeAll`	No	Include all career years (default: current season), e.g. includeAll=true

Example Request: JAVASCRIPT

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/breakdown' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Interesting H2H Matches

GET/tennis/v2/profile/{player_id_or_name}/interesting

Retrieve a player's most notable head-to-head rivalries, including the opponent's name, overall head-to-head record, tour type, and player profile images.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/interesting' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Profile filters

GET/tennis/v2/profile/{player_id_or_name}/filters

Retrieve all available filter options for tennis statistics and search endpoints, including court surfaces, tournament rounds, competition levels, and available seasons/years. Use these values to build valid filter queries for other API endpoints.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Novak Djokovic/filters' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Players By Search

GET/tennis/v2/profile/search/{name}/{tour_type}

Search for tennis players by surname and tour type (atp/wta), returning a list of matching player names.

Path Parameter

Parameter	Required	Description
`name`	Yes	Player display name (URL-encoded).
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Example Request: CURL

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

Get Player Next Matches

GET/tennis/v2/profile/{player_id_or_name}/upcoming

Returns the player's next scheduled match if one is available.

Path Parameter

Parameter	Required	Description
`player_id_or_name`	Yes	Can be either the player's name or numeric player ID.

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/profile/Jannik Sinner/upcoming' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'