Season Competitors

get

https://api.sportradar.com/handball/{access_level}/v2/{language_code}/seasons/{season_id}/competitors.{format}

Provides a list of teams participating for a given season.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
300s Time To Live / Cache

Data Points

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitor`	String	Abbreviation for a competitor name ex. `BEN` (HSG Bensheim/Auerbach)
`id`	`competitor`	String	Unique ID for a competitor ex. `sr:competitor:6445` (HSG Bensheim/Auerbach)
`long_name`	`competitor`	String	Alternate name for a competitor. ex. `Bensheim/A.`
`name`	`competitor`	String	Standard, full name for a competitor. ex. `HSG Bensheim/Auerbach`
`short_name`	`competitor`	String	Shortened name for a competitor, suited to compact or space-limited displays. ex. `Bensheim/Auerb.`
`virtual`	`competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

required

Defaults to en

2-letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

season_id

string

required

Defaults to sr:season:132716

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:121279

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Query Params

start

int32

The number of items to skip before starting to collect the result set.
Default: 0

Example: start=1000 to receive a 2nd page of results (if necessary)

Note: You may alternatively use offset

limit

int32

The number of items to return.
Maximum: 1000
Default value: 1000

Example: limit=5

Response

Update Frequency

Data Points

200200