Tennis

Get Tournament Profile

Retrieves full profile, surface, and title records for a tournament.

get/tennis/tournaments/{tournament_id}

Request

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

Path parameters

tournament_idstring required

Response

Successful Response

idstring required

Tournament ID

namestring required

Tournament name

tourstring required

Tour

levelstring required

Level tier

categorystring

Canonical event category: grand_slam, masters_1000, wta_1000, tour_finals, atp_tour, wta_tour, challenger, itf, davis_cup, billie_jean_king_cup, other. ATP 250 and ATP 500 both report atp_tour because the source does not separate them

tierstring

Tier name

surfacestring required

Surface

draw_sizeinteger

Draw size

citystring

City

country_codestring

Country code

first_edition_yearinteger

First recorded edition of this event

most_recent_edition_yearinteger

Most recent recorded edition

yearinteger

Edition year, the same field the list, draw and embedded forms of this tournament carry

is_live_shellboolean

True for a live-feed container (s365_*) holding archived live results, with default tier/surface and no geography

Changes

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