Season Lineups

get

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

Provides lineups for all matches in a given season.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
30s Time To Live / Cache

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a sport event's category ex. `DEU` (Germany)
`id`	`sport_event_context` - `category`	String	Unique category ID for a sport event ex. `sr:category:53`
`name`	`sport_event_context` - `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`	`sport_event_context` - `competition`	String	Gender for a sport event's competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a sport event's competition ex. `sr:competition:161` (Handbollsligan)
`name`	`sport_event_context` - `competition`	String	Name of a sport event's competition ex. `Handbollsligan`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group stage or playoff competitions ex. `sr:competition:945` used to link competitions together, like the World Cup and the various qualifiers.

Coverage Properties

Attribute	Parent Element	Type	Description
`type`	`sport_event` - `coverage`	String	Type of coverage for a sport event `sport_event`, `competition`
`basic_play_by_play`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic play-by-play is available for a group when `true`
`basic_player_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic player stats is available for a group when `true`
`basic_team_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic team stats is available for a group when `true`
`goal_scorers`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies goal scorers are available for a group when `true`
`lineups`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies goal lineups are available for a group when `true`
`scores`	`sport_event` - `coverage` - `sport_event_properties`	String	Describes the availability of scores as live or post-match `live`, `post`

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:83057` (Olympic Tournament 2024, Group A)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `Olympic Tournament 2024, Group A`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `A`

Rounds

Attribute	Parent Element	Type	Description
`competition_sport_event_number`	`sport_event_context` - `round`	Integer	Sport event number within a competition. Used for competitions that have fixed match numbers.
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:2029419`
`cup_round_number_of_sport_events`	`sport_event_context` - `round`	Integer	Number of events in a sport event's round
`cup_round_sport_event_number`	`sport_event_context` - `round`	Integer	Number within the `cup_round` of a match ID. For example, 1st leg of 2
`name`	`sport_event_context` - `round`	String	Name of a sport event's round ex. `quarterfinal` or `final`
`number`	`sport_event_context` - `round`	Integer	Number of a sport event's round
`other_sport_event_id`	`sport_event_context` - `round`	String	A linked sport event ID, typically in a two-legged tie ex. `sr:sport_event:47395897`

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:160` (EHF Euro)
`disabled`	`sport_event_context` - `season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`sport_event_context` - `season`	Date	End date of a season ex. `2024-11-03`
`id`	`sport_event_context` - `season`	String	Unique ID for a season ex. `sr:season:105127` (EHF Euro 2024)
`name`	`sport_event_context` - `season`	String	Name of a season ex. `EHF Euro 2024`
`start_date`	`sport_event_context` - `season`	Date	Start date of a season ex. `2024-03-29`
`year`	`sport_event_context` - `season`	String	Year of a season ex. `23/24` or `2024`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-10-01`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	`sport_event_context` - `stage`	String	Name of a sport event's stage ex. `regular season`, `qualification`, `playoffs` See the enum_phase entry in our Handball OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2024-03-20`
`type`	`sport_event_context` - `stage`	String	Type of a sport event's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a sport event's stage ex. `23/24` or `2024`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `RNL` (Rhein-Neckar Lowen)
`age_group`	`competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Germany`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `DEU` (Germany)
`gender`	`competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:4004` (Rhein-Neckar Lowen)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Rhein-Neckar Lowen`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a season `home`, `away`
`virtual`	`competitors` - `competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Manager

Attribute	Parent Element	Type	Description
`country_code`	`competitor` - `players` - `manager`	String	Country code of a manager ex. `DEU`
`date_of_birth`	`competitor` - `players` - `manager`	Date	Date of birth of a manager ex. `1979-04-26`
`gender`	`competitor` - `players` - `manager`	String	Gender of a manager `male`, `female`
`id`	`competitor` - `players` - `manager`	String	Unique ID of a manager ex. `sr:player:234198`
`name`	`competitor` - `players` - `manager`	String	Name of a manager ex. `Roberts, Dave`
`nationality`	`competitor` - `players` - `manager`	String	Nationality of a manager ex. `Germany`
`nickname`	`competitor` - `players` - `manager`	String	Nickname of a manager

Player

Attribute	Parent Element	Type	Description
`country_code`	`competitor` - `players` - `player`	String	Country code of a player ex. `DEU` (Germany)
`date_of_birth`	`competitor` - `players` - `player`	Date	Date of birth of a player ex. `2004-11-12`
`gender`	`competitor` - `players` - `player`	String	Gender of a player `male`, `female`
`height`	`competitor` - `players` - `player`	Integer	Height of a player in centimeters ex. `192`
`id`	`competitor` - `players` - `player`	String	Unique ID of a player ex. `sr:player:2300047`
`jersey_number`	`competitor` - `players` - `player`	Integer	Jersey number of a player
`name`	`competitor` - `players` - `player`	String	Name of a player ex. `Grupe, Magnus`
`nationality`	`competitor` - `players` - `player`	String	Nationality of a player ex. `Germany`
`nickname`	`competitor` - `players` - `player`	String	Nickname of a player
`played`	`competitor` - `players` - `player`	Boolean	Signifies a player appeared in a match when `true`
`starter`	`competitor` - `players` - `player`	Boolean	Signifies a player is in the starting lineup of a match when `true`
`type`	`competitor` - `players` - `player`	String	Position of a player `G`, `W`, `LW`, `RW`, `LB`, `RB`, `CB`, `P`, `DS`
`weight`	`competitor` - `players` - `player`	Integer	Weight of a player in kilograms ex. `95`

Sport Event

Attribute	Parent Element	Type	Description
`count`	`sport_event_conditions` - `attendance`	Integer	Attendance for a sport event ex. `13203`
`neutral`	`sport_event_conditions` - `ground`	Boolean	Signifies a neutral ground sport event when `true`
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:41192363`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:41192363`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team inning score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team inning score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Period number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type `regular_period`, `overtime`, `penalties`, `awaiting_penalties`, `1st_half`, `2nd_half`, `pause`, `1st_extra`, `2nd_extra`, `awaiting_extra`, `extra_time_halftime`, `interrupted`

Referee

Attribute	Parent Element	Type	Description
`id`	`sport_event_conditions` - `referees` - `referee`	String	Unique ID for a referee ex. `sr:referee:1289328`
`name`	`sport_event_conditions` - `referees` - `referee`	String	Name of a referee ex. `Nachevski, Gjorgji`
`nationality`	`sport_event_conditions` - `referees` - `referee`	String	Nationality of a referee ex. `North Macedonia`
`country_code`	`sport_event_conditions` - `referees` - `referee`	String	Country code of a referee ex. `MKD`
`type`	`sport_event_conditions` - `referees` - `referee`	String	Type of a referee ex. `referee`

Sport Event Status

Attribute	Parent Element	Type	Description
`aggregate_away_score`	`sport_event_status`	Integer	Aggregate score (of multiple sport events) for the away team
`aggregate_home_score`	`sport_event_status`	Integer	Aggregate score (of multiple sport events) for the home team
`aggregate_winner_id`	`sport_event_status`	String	Unique ID of the aggregate score winner ex. `sr:competitor:44`
`away_normaltime_score`	`sport_event_status`	Integer	Score for the away team in normal time
`away_overtime_score`	`sport_event_status`	Integer	Score for the away team in overtime
`away_score`	`sport_event_status`	Integer	Total score for the away team in the match
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time
`home_overtime_score`	`sport_event_status`	Integer	Score for the home team in overtime
`home_score`	`sport_event_status`	Integer	Total score for the home team in the match
`decided_by_fed`	`sport_event_status`	Boolean	Signifies a match result was decided by the federation when `true`. For example, incomplete due to crowd disruption
`match_status`	`sport_event_status`	String	Status within a match. Provides more detail on the state of a match when live than `status` ex. `not_started`, `2nd_half`, `ended`, `awaiting_penalties` See our Handball OpenAPI under enum_sport_event_match_status for a complete list of statuses
`match_tie`	`sport_event_status`	Boolean	Signifies a match ended in a tie when `true`
`count_abandoned`	`sport_event_status`	Boolean	Signifies a match was abandoned by a scout when `true`
`status`	`sport_event_status`	String	Status of a match ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions.
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:7578`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `13200`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_id`	`venue`	String	Unique ID of a city ex. `sr:city:59`
`city_name`	`venue`	String	City name of a venue ex. `Mannheim`
`country_code`	`venue`	String	Country code of a venue ex. `DEU`
`country_name`	`venue`	String	Country name of a venue ex. `Germany`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:2010`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `49.463730,8.517570`
`name`	`venue`	String	Name of a venue ex. `SAP Arena`
`reduced_capacity`	`venue`	Boolean	Optional attribute signifying a venue has a restricted capacity when `true`
`reduced_capacity_max`	`venue`	Integer	Value of a venue's restricted capacity
`timezone`	`venue`	String	Timezone of a venue ex. `Europe/Berlin`

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=100 to receive a 2nd page of results (if necessary)

Note: You may alternatively use offset

limit

int32

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

Example: limit=5

Note: Pagination will often be required to pull all data within this feed. By default, the feed will return 100 sport events.

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json