Tennis

List & Filter Tournaments

Retrieves catalog of tennis tournaments across history.

get/tennis/tournaments

Request

  • Base URL: https://api.citoapi.com/api/v1
  • URL: https://api.citoapi.com/api/v1/tennis/tournaments
  • Auth: API key in header x-api-key

Query parameters

tourstring

ATP or WTA

qstring

Case-insensitive name search, same as /players?q=

yearinteger

Edition year, e.g. 2026

levelstring

Level tier code: G, M, A, F, D, C

surfacestring

Surface: Hard, Clay, Grass, Carpet

include_live_shellsboolean

Include live-feed containers (s365_*) that hold archived live results; excluded by default because they are not real events

country_codestring

Country IOC code

pageinteger

Page number (1-indexed)

page_sizeinteger

Items per page

limitinteger

Alias for page_size

Response

Successful Response

totalinteger required

Total count of items matching filter criteria

pageinteger required

Current page number (1-indexed)

page_sizeinteger required

Number of items per page

total_pagesinteger required

Total number of available pages

has_nextboolean required

Whether there is a subsequent page

has_prevboolean required

Whether there is a preceding page

Changes

No recorded changes to this operation across all 1 revision of this API.