Season Info

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

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

⏱️
Update Frequency
300s Time To Live / Cache

Data Points

Category & Sport:

Attribute	Parent Element	Type	Description
`country_code`	`season` - `category`	String	Country code for a sport event's category ex. `DEU` (Germany)
`id`	`season` - `category`	String	Unique category ID for a sport event ex. `sr:category:53`
`name`	`season` - `category`	String	Name for a sport event's category ex. `Germany`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a sport event ex. `sr:sport:6`
`name`	`sport_event_context` - `sport`	String	Name for a sport event's sport ex. `Handball`

Competition:

Attribute	Parent Element	Type	Description
`gender`	`season` - `competition`	String	Gender for a competition `men`, `women`
`id`	`season` - `competition`	String	Unique ID for a competition ex. `sr:competition:161` (Handbollsligan)
`name`	`season` - `competition`	String	Name of a competition ex. `Handbollsligan`
`parent_id`	`season` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions
`competition_status`	`season` - `info`	String	Status of a competition Data point not currently in use
`venue_reduced_capacity`	`season` - `info`	Boolean	Signifies venues within this competition have a reduced capacity when `true`
`venue_reduced_capacity_max`	`season` - `info`	Integer	Maximum capacity for a venue

Coverage Properties:

Attribute	Parent Element	Type	Description
`type`	`coverage`	String	Type of coverage for a competition `sport_event`, `competition`
`brackets`	`coverage` - `competition_properties`	Boolean	Signifies brackets in the Season Links endpoint are available for this season when `true`
`schedules`	`coverage` - `competition_properties`	Boolean	Signifies a schedule of fixtures is available for this season when `true`
`standings`	`coverage` - `competition_properties`	String	Defines whether a season's standings are available live or post-match `live`, `post`
`team_squads`	`coverage` - `competition_properties`	Boolean	Signifies team squads are available for competitors within this season when `true`
`basic_play_by_play`	`coverage` - `sport_event_properties`	Boolean	Signifies basic play-by-play of a competition's sport events are available when `true`
`basic_player_stats`	`coverage` - `sport_event_properties`	Boolean	Signifies basic player stats of a competition's sport events are available when `true`
`basic_team_stats`	`coverage` - `sport_event_properties`	Boolean	Signifies basic team stats of a competition's sport events are available when `true`
`basic_team_stats`	`coverage` - `sport_event_properties`	Boolean	Signifies basic team stats of a competition's sport events are available when `true`
`goal_scorers`	`group` - `coverage` - `sport_event_properties`	Boolean	Signifies goal scorers of a competition's sport events are available when `true`
`lineups`	`group` - `coverage` - `sport_event_properties`	Boolean	Signifies goal lineups of a competition's sport events are available when `true`
`scores`	`coverage` - `sport_event_properties`	Strings	Indicates when a competition's sport event scores are made available `live`, `post` (Postgame)

Groups:

Attribute	Parent Element	Type	Description
`id`	`stage` - `groups` - `group`	String	Unique ID for a group ex. `sr:league:league` (EHF Champions League 23/24, Group A)
`name`	`stage` - `groups` - `group`	String	Name of a group ex. `EHF Champions League 23/24, Group A`
`group_name`	`stage` - `groups` - `group`	String	Abbreviated name of a group ex. `A`
`max_rounds`	`stage` - `groups` - `group`	Integer	Maximum number of rounds for a stage or season

Seasons:

Attribute	Parent Element	Type	Description
`competition_id`	`season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:30` (Champions League)
`disabled`	`season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`season`	Date	End date of a season ex. `2024-06-09`
`id`	`season`	String	Unique ID for a season ex. `sr:season:107719` (Champions League 23/24)
`name`	`season`	String	Name of a season ex. `Champions League 23/24`
`start_date`	`season`	Date	Start date of a season ex. `2023-09-12`
`year`	`season`	String	Year of a season ex. `23/24`

Stages:

Attribute	Parent Element	Type	Description
`end_date`	`stage`	Date	End date of a season or stage ex. `2024-03-07`
`order`	`stage`	Integer	Order of a stage within a season
`phase`	`stage`	String	Name of a season or stage ex. `regular season`, `conference`, `playoffs` See the enum_phase entry in our Handball OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`stage`	Date	Start date of a season or stage ex. `2023-09-12`
`type`	`stage`	String	Type of a season or stage `cup`, `league`
`year`	`stage`	String	Year of a season or stage ex. `23/24`

Competitor:

Attribute	Parent Element	Type	Description
`abbreviation`	`form_standing` - `competitor`	String	Abbreviation for a competitor name ex. `RNL` (Rhein-Neckar Lowen)
`age_group`	`form_standing` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`form_standing` - `competitor`	String	Country of a competitor ex. `Germany`
`country_code`	`form_standing` - `competitor`	String	Country code of a competitor ex. `DEU` (Germany)
`gender`	`form_standing` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`form_standing` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:4004` (Rhein-Neckar Lowen)
`name`	`form_standing` - `competitor`	String	Name for a competitor ex. `Rhein-Neckar Lowen`

Language

Credentials

Header

Click Try It! to start a request and see the response here!