Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides detailed information for a given season, including participating competitors and league structure.

⏱️

Update Frequency

300s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codeseason - categoryStringCountry code for a season category
idseason - categoryStringUnique category ID for a season
ex. sr:category:88 (International)
nameseason - categoryStringName for a season category
ex. ATP
idseason - sportStringUnique sport ID for a season
ex. sr:sport:20
nameseason - sportStringName for a season's sport
ex. Table Tennis
Competition:
AttributeParent ElementTypeDescription
genderseason - competitionStringGender for a competition
ex. men, women, mixed
idseason - competitionStringUnique ID for a competition
ex. sr:competition:564 (Olympic Tournament)
nameseason - competitionStringName of a competition
ex. Olympic Tournament, Australian Open (WTP), Women Doubles
parent_idseason - competitionStringUnique parent ID for a competition.
ex. sr:competition:2334 is used to group all Australian Open competitions.
typeseason - competitionStringType of a competition
ex. singles, doubles, mixed_doubles
Groups:
AttributeParent ElementTypeDescription
idstage - groups - groupStringUnique ID for a stage or season's group
ex. sr:cup:173473 (ETTU European Championships 2024, XD)
max_roundsstage - groups - groupIntegerMaximum number of rounds for a stage or season
namestage - groups - groupStringName of a stage or season's group
ex. Group A or Olympic Tournament 2024, Preliminary Rounds
group_namestage - groups - groupStringAbbreviated name of a stage or season's group
ex. A
Season Info:
AttributeParent ElementTypeDescription
competition_statusseason - infoStringStatus of a competition

Data point not currently in use
venue_reduced_capacityseason - infoBooleanSignifies venues within this competition have a reduced capacity when true
venue_reduced_capacity_maxseason - infoIntegerMaximum capacity for a venue
Season:
AttributeParent ElementTypeDescription
competition_idseasonStringUnique ID for the competition a season belongs to
ex. sr:competition:564 (Olympic Tournament)
disabledseasonBooleanSignifies a season has been disabled when true
end_dateseasonDateEnd date of a season
ex. 2025-07-13
idseasonStringUnique ID for a season
ex. sr:season:105599 (Olympic Games 2024)
nameseasonStringName of a season
ex. Olympic Games 2024
start_dateseasonDateStart date of a season
ex. 2025-06-23
yearseasonStringYear of a season
ex. 24/25 or 2025
Stages:
AttributeParent ElementTypeDescription
end_datestageDateEnd date of a season or stage
ex. 2024-07-14
orderstageIntegerOrder of a stage within a season
phasestageStringName of a season or stage
ex. ms (men singles), md (men doubles), ws (women singles), wd (women doubles), xd (mixed doubles)

See the enum_phase entry in our Table Tennis OpenAPI spec for a complete list of valid phase enum values
start_datestageDateStart date of a season or stage
ex. 2024-06-24
typestageStringType of a season or stage
cup, league
yearstageStringYear of a season or stage
ex. 23/24 or 2024
Competitor:

Competitors can be a player or a doubles team

AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name (singles or doubles)
ex. SUN (Sun, Yingsha), G/P (Gardos R / Polcanova S)
countrycompetitors - competitorStringCountry of a competitor
ex. China
country_codecompetitors - competitorStringCountry code of a competitor
ex. CHN
date_of_birthcompetitor - competitorDateDate of birth of a competitor
ex. 1996-02-28
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:344054
namecompetitors - competitorStringName for a competitor (singles or doubles)
ex. Sun, Yingsha, Gardos R / Polcanova S
qualifiercompetitors - competitorStringDesignation of a competitor for a match
home, away
virtualcompetitors - competitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Player:

Competitors will appear under a players node when part of a doubles competition.

AttributeParent ElementTypeDescription
abbreviationcompetitor - players - playerStringAbbreviation for a player name
ex. GAR (Gardos, Robert)
countrycompetitor - players - playerStringCountry of a competitor
ex. China
country_codecompetitor - players - playerStringCountry code of a competitor
ex. CHN
date_of_birthcompetitor - players - playerDateDate of birth of a player
ex. 1994-07-05
idcompetitor - players - playerStringUnique ID for a competitor
ex. sr:competitor:25084
namecompetitor - players - playerStringName for a competitor
ex. Gardos, Robert
Language
Credentials
Query
Click Try It! to start a request and see the response here!