Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Competitors

Displays a listing of all competitors with respective IDs that compete in a given season.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL/Cache: 300 seconds

Data Updates (Tier 1):

  • Tournaments added at the end of the previous season
  • Player Data check two weeks before competition start

Data Points

Competitor

Competitors can be a player, a doubles team, or a national team

AttributeParent ElementTypeDescription
abbreviationcompetitorStringAbbreviation for a competitor name

ex. PAU (Tommy Paul) or G/M ('Glasspool L / Middelkoop M' doubles team)
idcompetitorStringUnique ID for a competitor

ex. sr:competitor:138546
namecompetitorStringName for a competitor

ex. Paul, Tommy or Glasspool L / Middelkoop M (doubles team)
short_namecompetitorStringex. Paul, Tommy or Glasspool L / Middelkoop M (doubles team)
Player

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

AttributeParent ElementTypeDescription
abbreviationcompetitor - players - playerStringAbbreviation for a competitor name

ex. PAU (Tommy Paul)
countrycompetitor - players - playerStringCountry of a competitor

ex. USA
country_codecompetitor - players - playerStringCountry code of a competitor

ex. USA
idcompetitor - players - playerStringUnique ID for a competitor

ex. sr:competitor:138546
namecompetitor - players - playerStringName for a competitor

ex. Paul, Tommy
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

de (German), en (English), es (Spanish), fr (French), id (Indonesian), it (Italian), ja (Japanese), ru (Russian), th (Thai), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
required
Defaults to sr:season:120983

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:107797

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json