API Reference

Calendar Filters & Grand Slam Champions

The year calendar lives on Tournaments & Draws → Tournament Calendar. This page is extra calendar helpers only (filter metadata and Grand Slam rows), not a second year calendar.

Tournament Calendar Filter Options

GET/tennis/v2/calendar/atp/filters

This example uses atp. Use wtafor the women's dataset.Returns all available filter options for the calendar endpoints (Tournament Calendar with Filters), including supported years, tournament levels, and court surfaces.

Path Parameter

Parameter	Required	Type	Description
`atp\|wta`	Yes	string	Dataset to query. `atp` = men's tennis across all supported levels, including Grand Slams, ATP Tour, Challengers and ITF. `wta` = women's tennis across all supported levels, including Grand Slams, WTA Tour and ITF. There is no separate `itf` value.

Example Request: CURL

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

Grand Slam Champions

GET/tennis/v2/calendar/atp/grand-slam-champions

This example uses atp. Use wtafor the women's dataset.Returns Grand Slam calendar rows. level is forced to Grand Slam on this route — other level values are ignored. year defaults to the current year.

Path Parameter

Parameter	Required	Type	Description
`atp\|wta`	Yes	string	Dataset to query. `atp` = men's tennis across all supported levels, including Grand Slams, ATP Tour, Challengers and ITF. `wta` = women's tennis across all supported levels, including Grand Slams, WTA Tour and ITF. There is no separate `itf` value.

Query Parameter

Parameter	Required	Type	Description
`year`	No	integer	Season year. Default is the current year. Example: `year=2026`.
`level`	No	string	Tournament level name from `/calendar/{tour}/filters`. Example: `level=Grand Slam`. Numeric ids return an empty list.
`surfaces`	No	string	Surface name from filters, e.g. `Hard`, `Clay`, `I.hard`.
`surface`	No	string	Filter by surface name. Alias of court. Example: surface=clay or court=Clay.
`search`	No	string	Tournament name search. Example: `search=Open`.
`sortOrder`	No	string	Date sort: `ASC` or `DESC`.
`page`	No	integer	Page number on advanced routes, starting at 1. Do not send pageNo here. Example: page=1
`limit`	No	integer	Results per page on advanced routes (use page + limit, not pageNo + pageSize). Default varies by endpoint. Example: limit=10

Example Request: CURL

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

Response Properties

Field	Type	Description
`(root)`	array	A JSON array of tournaments (not wrapped in data).
`name`	string	Tournament name. Reuse this (URL-encoded) on advanced tournament routes.
`date`	string	Start date as ISO-8601.
`prize`	string	Prize-money label when published.
`court / rank`	object	Surface and level objects (id + name).
`games`	array	Matches played at that event, with nested player objects and stats when available.