---
updatedAt: 2026-07-28T07:48:31.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/soccer/llms.txt
---
# Sport Event Lineups
**Soccer Extended Sport Event Lineups** provides detailed roster information for a given match. Starting players, substitutions, formation type, and channel availability are included if supported by coverage level.
### Update Frequency
1s Time To Live / Cache
> 📘 Displaying Lineups
>
> Learn how to use Sport Event Lineups for starting lineups and formations in our [Rosters, Lineups, and Transfers](https://developer.sportradar.com/soccer/docs/soccer-ig-rosters-lineups-transfers) integration scenario.
***
## Data Points
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country_code` | `sport_event_context` - `category` | String | Country code for a sport event's category
ex. `ENG` (England) |
| `id` | `sport_event_context` - `category` | String | Unique category ID for a sport event
ex. `sr:category:1` |
| `name` | `sport_event_context` - `category` | String | Name for a sport event's category
ex. `England` (Premier League) |
| `id` | `sport_event_context` - `sport` | String | Unique sport ID for a sport event
ex. `sr:sport:1` |
| `name` | `sport_event_context` - `sport` | String | Name for a sport event's sport
ex. `Soccer` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `alternative_name` | `sport_event_context` - `competition` | String | Alternate name of a competition
ex. `English Premier League` (instead of `Premier League`) |
| `gender` | `sport_event_context` - `competition` | String | Gender for a competition
ex. `men` |
| `id` | `sport_event_context` - `competition` | String | Unique ID for a competition
ex. `sr:competition:17` (Premier League) |
| `name` | `sport_event_context` - `competition` | String | Name of a competition
ex. `Premier League` |
| `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. |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `sport_event_context` - `groups` - `group` | String | Unique ID for a sport event's group
ex. `sr:league:80253` (UEFA Euro 2024, Group D) |
| `name` | `sport_event_context` - `groups` - `group` | String | Name of a sport event's group
ex. `UEFA Euro 2024, Group D` |
| `group_name` | `sport_event_context` - `groups` - `group` | String | Abbreviated name of a sport event's group
ex. `D` |
| 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 (World Cup) |
| `cup_round_id` | `sport_event_context` - `round` | String | Unique ID for a sport event's cup round
ex. `sr:cup_round:1988995` |
| `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. `round_3` or `round_of_16` |
| `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` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `competition_id` | `sport_event_context` - `season` | String | Unique ID for the competition a sport event belongs to
ex. `sr:competition:17` (Premier League) |
| `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 sport event's season
ex. `2024-05-19` |
| `id` | `sport_event_context` - `season` | String | Unique ID for a sport event's season
ex. `sr:season:105353` (Premier League 23/24) |
| `name` | `sport_event_context` - `season` | String | Name of a sport event's season
ex. `Premier League 23/24` |
| `start_date` | `sport_event_context` - `season` | Date | Start date of a sport event's season
ex. `2023-08-11` |
| `year` | `sport_event_context` - `season` | String | Year of a sport event's season
ex. `23/24` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `end_date` | `sport_event_context` - `stage` | Date | End date of a sport event's stage
ex. `2024-05-19` |
| `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`, `preliminary_round`, `qualification` |
| `start_date` | `sport_event_context` - `stage` | Date | Start date of a sport event's stage
ex. `2023-08-11` |
| `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` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `abbreviation` | `competitors` - `competitor` | String | Abbreviation for a competitor name
ex. `LIV` (Liverpool FC) |
| `age_group` | `competitors` - `competitor` | String | Age group of a competitor, when applicable
ex. `U23` |
| `country` | `competitors` - `competitor` | String | Country of a competitor
ex. `England` |
| `country_code` | `competitors` - `competitor` | String | Country code of a competitor
ex. `ENG` (England) |
| `gender` | `competitors` - `competitor` | String | Gender for a competitor
`male`, `female` |
| `id` | `competitors` - `competitor` | String | Unique ID for a competitor
ex. `sr:competitor:44` (Liverpool FC) |
| `name` | `competitors` - `competitor` | String | Name for a competitor
ex. `Liverpool FC` |
| `qualifier` | `competitors` - `competitor` | String | Designation of a competitor for a sport event
`home`, `away` |
| `virtual` | `competitors` - `competitor` | Boolean | Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups. |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `base` | `competitor` - `jersey` | String | RGB color code of a competitor's base jersey
ex. `e41e2c` |
| `horizontal_stripes` | `competitor` - `jersey` | Boolean | Signifies a competitor's jersey has horizontal stripes when `true` |
| `horizontal_stripes_color` | `competitor` - `jersey` | String | RGB color code of a competitor's horizontal jersey stripes
ex. `e41e2c` |
| `number` | `competitor` - `jersey` | String | RGB color code of a competitor's jersey number
ex. `ffffff` |
| `shirt_type` | `competitor` - `jersey` | String | Shirt type of a competitor's jersey
ex. `short_sleeves` |
| `sleeve` | `competitor` - `jersey` | String | RGB color code of a competitor's jersey sleeves
ex. `e41e2c` |
| `sleeve_detail` | `competitor` - `jersey` | String | RGB color code of a competitor's jersey sleeves detail
ex. `ffffff` |
| `split` | `competitor` - `jersey` | Boolean | Signifies a competitor's jersey is split when `true` |
| `split_color` | `competitor` - `jersey` | String | RGB color code of a competitor's jersey split
ex. `ffffff` |
| `squares` | `competitor` - `jersey` | Boolean | Signifies a competitor's jersey is squares when `true` |
| `squares_color` | `competitor` - `jersey` | String | RGB color code of a competitor's jersey squares
ex. `ffffff` |
| `stripes` | `competitor` - `jersey` | Boolean | Signifies a competitor's jersey has stripes when `true` |
| `stripes_color` | `competitor` - `jersey` | String | RGB color code of a competitor's jersey stripes
ex. `ffffff` |
| `type` | `competitor` - `jersey` | String | Type of competitor jersey entry
ex. `home`, `away`, `goalkeeper`, `third` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country_code` | `competitor` - `manager` | String | Country code of a manager
ex. `ENG` (England) |
| `date_of_birth` | `competitor` - `manager` | Date | Date of birth of a manager
ex. `1967-06-16` |
| `gender` | `competitor` - `manager` | String | Gender of a manager
`male`, `female` |
| `id` | `competitor` - `manager` | String | Unique ID of a manager
ex. `sr:player:52829` |
| `name` | `competitor` - `manager` | String | Name of a manager
ex. `Klopp, Jurgen` |
| `nationality` | `competitor` - `manager` | String | Nationality of a manager
ex. `Germany` |
| `nickname` | `competitor` - `manager` | String | Nickname of a manager |
| `preferred_foot` | `competitor` - `manager` | String | Preferred foot of a manager
`left`, `right` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `captain` | `player` | Boolean | Indicates the player is the team captain for the match when `true`. Populates when `lineups.confirmed` moves to `true`. |
| `country_code` | `player` | String | Country code of a player
ex. `EGY` (Egypt) |
| `date_of_birth` | `player` | Date | Date of birth of a player
ex. `1992-06-15` |
| `gender` | `player` | String | Gender of a player
`male`, `female` |
| `height` | `player` | Integer | Height of a player in centimeters
ex. `175` |
| `id` | `player` | String | Unique ID of a player
ex. `sr:player:159665` |
| `jersey_number` | `player` | Integer | Jersey number of a player |
| `name` | `player` | String | Name of a player
ex. `Salah, Mohamed` |
| `nationality` | `player` | String | Nationality of a player
ex. `Egypt` |
| `nickname` | `player` | String | Nickname of a player |
| `place_of_birth` | `player` | String | Place of birth of a player
ex. `Basyoun, El Gharbia` |
| `played` | `player` | Boolean | Signifies a player appeared in a match when `true` |
| `preferred_foot` | `player` | String | Preferred foot of a player
`left`, `right` |
| `starter` | `player` | Boolean | Signifies a player is in the starting lineup of a match when `true` |
| `type` | `player` | String | Position of a player
`goalkeeper`, `defender`, `midfielder`, `forward` |
| `weight` | `player` | Integer | Weight of a player in kilograms
ex. `71` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `count` | `sport_event_conditions` - `attendance` | Integer | Attendance for a sport event
ex. `25078` |
| `neutral` | `sport_event_conditions` - `ground` | Boolean | Signifies a neutral ground sport event when `true` |
| `confirmed` | `sport_event_conditions` - `lineups` | Boolean | Signifies lineups for a sport event have been confirmed when `true` |
| `id` | `sport_event` | String | Unique ID of a sport event
ex. `sr:sport_event:47395897` |
| `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:47395897` |
| `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` |
| `date_confirmed` | `sport_event` | Boolean | Indicates whether the event date is confirmed (`true`). This applies when the calendar day is finalized, but the exact start time has not yet been determined. |
| `overall_conditions` | `sport_event_conditions` - `weather` | String | Weather conditions for a sport event
`good`, `medium`, `bad`, `indoor`, `extreme` |
| `pitch_conditions` | `sport_event_conditions` - `weather` | String | Pitch conditions for a sport event
`good`, `medium`, `bad` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country` | `sport_event` - `channels` - `channel` | String | Country of a broadcast channel
ex. `United States` |
| `country_code` | `sport_event` - `channels` - `channel` | String | Country code of a broadcast channel
ex. `USA` |
| `name` | `sport_event` - `channels` - `channel` | String | Name of a broadcast channel
ex. `Fox Soccer Plus` |
| `url` | `sport_event` - `channels` - `channel` | String | URL of a broadcast channel |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `sport_event_conditions` - `referees` - `referee` | String | Unique ID for a referee
ex. `sr:referee:229470` |
| `name` | `sport_event_conditions` - `referees` - `referee` | String | Name of a referee
ex. `Brooks, John` |
| `nationality` | `sport_event_conditions` - `referees` - `referee` | String | Nationality of a referee
ex. `England` |
| `country_code` | `sport_event_conditions` - `referees` - `referee` | String | Country code of a referee
ex. `ENG` |
| `type` | `sport_event_conditions` - `referees` - `referee` | String | Type of a referee
ex. `first_assistant_referee`, `second_assistant_referee`, `fourth_official`, `video_assistant_referee`, `first_additional_assistant`, `second_additional_assistant`, `main_referee` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `type` | `sport_event` - `coverage` | String | Type of coverage
`sport_event`, `group`, `competition` |
| `ballspotting` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies ballspotting is available for a sport event when `true` |
| `basic_play_by_play` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies basic play-by-play is available for a sport event when `true` |
| `basic_player_stats` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies basic player stats is available for a sport event when `true` |
| `basic_team_stats` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies basic team stats is available for a sport event when `true` |
| `commentary` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies commentary is available for a sport event when `true` |
| `deeper_play_by_play` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies deeper play-by-play is available for a sport event when `true` |
| `deeper_player_stats` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies deeper player stats is available for a sport event when `true` |
| `deeper_team_stats` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies deeper team stats is available for a sport event when `true` |
| `extended_play_by_play` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies extended play-by-play data is available for a sport event when `true`. Access this data in the [Sport Event Extended Timeline](https://developer.sportradar.com/soccer/reference/soccer-extended-sport-event-extended-timeline) endpoint. |
| `extended_player_stats` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies extended player stats is available for a sport event when `true` |
| `extended_team_stats` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies extended team stats is available for a sport event when `true` |
| `formations` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies team formations are available for a sport event when `true` |
| `fun_facts` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies fun facts are available for a sport event when `true` |
| `game_clock` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies the game clock is available for a sport event when `true` |
| `goal_scorers` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies goal scorers are available for a sport event when `true` |
| `goal_scorers_live` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies goal scorers are available live for a sport event when `true` |
| `lineups` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies goal lineups are available for a sport event when `true` |
| `lineups_availability` | `sport_event` - `coverage` - `sport_event_properties` | String | Describes the availability of lineups as pre-match or post-match
`pre`, `post` |
| `probabilities` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies probabilities are available for a sport event when `true`
Note: Attribute is not currently supported |
| `scores` | `sport_event` - `coverage` - `sport_event_properties` | String | Describes the availability of scores as live or post-match
`live`, `post` |
| `venue` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies venue info is available for a sport event when `true` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `status` | `sport_event_status` - `match_situation` | String | Current situation status of a match
`safe`, `dangerous`, `attack` |
| `qualifier` | `sport_event_status` - `match_situation` | String | Defines the team in the current situation status
`home`, `away` |
| `updated_at` | `sport_event_status` - `match_situation` | Date-Time | Timestamp of the most recent match situation update
ex. `2024-04-14T14:57:28+00:00` |
| `away_score` | `sport_event_status` - `period_scores` - `period_score` | Integer | Away team period score |
| `home_score` | `sport_event_status` - `period_scores` - `period_score` | Integer | Home team period 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`, `pause`, `awaiting_extra`, `extra_time_halftime`, `interrupted` |
| 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 [FAQ](https://developer.sportradar.com/soccer/reference/soccer-extended-faq#sport-statuses) for a complete list of statuses and their definitions. |
| `match_tie` | `sport_event_status` | Boolean | Signifies a match ended in a tie when `true` |
| `scout_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`, `awaiting_penalties`
See our [FAQ](https://developer.sportradar.com/soccer/reference/soccer-extended-faq#sport-statuses) for a complete list of statuses and their definitions. |
| `winner_id` | `sport_event_status` | String | Unique ID of the match winner
ex. `sr:competitor:44` |
> Visit our [FAQ](https://developer.sportradar.com/soccer/reference/soccer-extended-faq#ball-location) for additional information on ball location data.
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `order` | `sport_event_status` - `ball_locations` - `ball_location` | Integer | Sequential order of a ball location event. The most recent location is `4` and the oldest location is `1`. |
| `qualifier` | `sport_event_status` - `ball_locations` - `ball_location` | String | Designation of a competitor for a ball location entry
`home`, `away` |
| `x` | `sport_event_status` - `ball_locations` - `ball_location` | String | Horizontal X coordinate of the pitch. `x` is a number between `0` and `100`. The reference point `0` is at the home team’s goal. |
| `y` | `sport_event_status` - `ball_locations` - `ball_location` | String | Vertical Y coordinate of the pitch. `y` is a number between `0` and `100`. The reference point `0` is on the top of the pitch where the home team’s goal is on the left hand side. |
> See our [Extended Statistics FAQ](https://developer.sportradar.com/soccer/reference/soccer-extended-faq#extended-statistics) for in-depth definitions of key data points
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `assists` | `player` - `statistics` | Integer | Player assists for a match |
| `chances_created` | `player` - `statistics` | Integer | Player chances created for a match |
| `clearances` | `player` - `statistics` | Integer | Player clearances for a match |
| `corner_kicks` | `player` - `statistics` | Integer | Player corner kicks for a match |
| `crosses_successful` | `player` - `statistics` | Integer | Player successful crosses for a match |
| `crosses_total` | `player` - `statistics` | Integer | Player total crosses for a match |
| `defensive_blocks` | `player` - `statistics` | Integer | Player defensive blocks for a match |
| `diving_saves` | `player` - `statistics` | Integer | Player diving saves for a match |
| `dribbles_completed` | `player` - `statistics` | Integer | Player dribbles completed for a match |
| `fouls_committed` | `player` - `statistics` | Integer | Player fouls committed for a match |
| `goals_by_head` | `player` - `statistics` | Integer | Player goals by head for a match |
| `goals_by_penalty` | `player` - `statistics` | Integer | Player goals by penalty for a match |
| `goals_conceded` | `player` - `statistics` | Integer | Player goals conceded for a match |
| `goals_scored` | `player` - `statistics` | Integer | Player goals scored for a match |
| `interceptions` | `player` - `statistics` | Integer | Player interceptions for a match |
| `long_passes_successful` | `player` - `statistics` | Integer | Player successful long passes for a match |
| `long_passes_total` | `player` - `statistics` | Integer | Player total long passes for a match |
| `long_passes_unsuccessful` | `player` - `statistics` | Integer | Player unsuccessful long passes for a match |
| `loss_of_possession` | `player` - `statistics` | Integer | Player possession losses for a match |
| `minutes_played` | `player` - `statistics` | Integer | Player minutes played for a match |
| `offsides` | `player` - `statistics` | Integer | Player offsides for a match |
| `own_goals` | `player` - `statistics` | Integer | Player own goals for a match |
| `passes_successful` | `player` - `statistics` | Integer | Player successful passes for a match |
| `passes_total` | `player` - `statistics` | Integer | Player total passes for a match |
| `passes_unsuccessful` | `player` - `statistics` | Integer | Player unsuccessful passes for a match |
| `penalties_faced` | `player` - `statistics` | Integer | Player penalty shots faced for a match |
| `penalties_missed` | `player` - `statistics` | Integer | Player penalty shots missed for a match |
| `penalties_saved` | `player` - `statistics` | Integer | Player penalty shots saved for a match |
| `red_cards` | `player` - `statistics` | Integer | Player red cards for a match |
| `shots_blocked` | `player` - `statistics` | Integer | Player shots blocked for a match |
| `shots_faced_saved` | `player` - `statistics` | Integer | Player shots saved for a match |
| `shots_faced_total` | `player` - `statistics` | Integer | Player total shots faced for a match |
| `shots_off_target` | `player` - `statistics` | Integer | Player shots off target for a match |
| `shots_on_target` | `player` - `statistics` | Integer | Player shots on target for a match |
| `substituted_in` | `player` - `statistics` | Integer | Signifies a player was substituted in during a match when `1` |
| `substituted_out` | `player` - `statistics` | Integer | Signifies a player was substituted out during a match when `1` |
| `tackles_successful` | `player` - `statistics` | Integer | Player successful tackles for a match |
| `tackles_total` | `player` - `statistics` | Integer | Player total tackles for a match |
| `was_fouled` | `player` - `statistics` | Integer | Number of fouls against a player in a match |
| `yellow_cards` | `player` - `statistics` | Integer | Player yellow cards for a match |
| `yellow_red_cards` | `player` - `statistics` | Integer | Player red cards for a match resulting from two yellow cards |
> See our [Extended Statistics FAQ](https://developer.sportradar.com/soccer/reference/soccer-extended-faq#extended-statistics) for in-depth definitions of key data points
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `ball_possession` | `competitor` - `statistics` | Integer | Percentage of team ball possession for a match.
ex. `43` |
| `cards_given` | `competitor` - `statistics` | Integer | Total cards given to a team in a match |
| `chances_created` | `competitor` - `statistics` | Integer | Total chances created for a team in a match |
| `clearances` | `competitor` - `statistics` | Integer | Total clearances for a team in a match |
| `corner_kicks` | `competitor` - `statistics` | Integer | Total team corner kicks for a match |
| `crosses_successful` | `competitor` - `statistics` | Integer | Total successful crosses for a team in a match |
| `crosses_total` | `competitor` - `statistics` | Integer | Total crosses for a team in a match |
| `crosses_unsuccessful` | `competitor` - `statistics` | Integer | Total unsuccessful crosses for a team in a match |
| `defensive_blocks` | `competitor` - `statistics` | Integer | Total team defensive blocks for a match |
| `diving_saves` | `competitor` - `statistics` | Integer | Total team diving saves for a match |
| `fouls` | `competitor` - `statistics` | Integer | Total number of fouls awarded against a team (including those which draw cards) |
| `free_kicks` | `competitor` - `statistics` | Integer | Team free kicks for a match. In accordance with the rules, a free kick stat counted for the team who executes a free kick. Direct or indirect free kicks are all counted as free kicks. |
| `goal_kicks` | `competitor` - `statistics` | Integer | Team goal kicks for a match. Total number of kicks awarded to the team as a result of the ball traveling out of bounds over the goal line of the defending team. |
| `injuries` | `competitor` - `statistics` | Integer | Total team injuries for a match |
| `interceptions` | `competitor` - `statistics` | Integer | Total team interceptions for a match |
| `long_passes_successful` | `competitor` - `statistics` | Integer | Total successful long passes for a team in a match |
| `long_passes_total` | `competitor` - `statistics` | Integer | Total long passes for a team in a match |
| `long_passes_unsuccessful` | `competitor` - `statistics` | Integer | Total unsuccessful long passes for a team in a match |
| `offsides` | `competitor` - `statistics` | Integer | Total team offside infringements for a match |
| `passes_successful` | `competitor` - `statistics` | Integer | Total successful passes for a team in a match |
| `passes_total` | `competitor` - `statistics` | Integer | Total passes for a team in a match |
| `passes_unsuccessful` | `competitor` - `statistics` | Integer | Total unsuccessful passes for a team in a match |
| `penalties_missed` | `competitor` - `statistics` | Integer | Total team penalty shots missed for a match |
| `red_cards` | `competitor` - `statistics` | Integer | Total team red cards for a match |
| `shots_blocked` | `competitor` - `statistics` | Integer | Total team shots blocked for a match |
| `shots_off_target` | `competitor` - `statistics` | Integer | Total team off-target shots for a match |
| `shots_on_target` | `competitor` - `statistics` | Integer | Total team on-target shots for a match |
| `shots_saved` | `competitor` - `statistics` | Integer | Total number of goal keeper saves attributed to a team for a match |
| `shots_total` | `competitor` - `statistics` | Integer | Total number of shots attributed to a team for a match |
| `substitutions` | `competitor` - `statistics` | Integer | Total number player substitutions in a match |
| `tackles_successful` | `competitor` - `statistics` | Integer | Total successful tackles for a team in a match |
| `tackles_total` | `competitor` - `statistics` | Integer | Total tackles for a team in a match |
| `tackles_unsuccessful` | `competitor` - `statistics` | Integer | Total unsuccessful tackles for a team in a match |
| `throw_ins` | `competitor` - `statistics` | Integer | Total number of throw-in events for a team during a match |
| `was_fouled` | `competitor` - `statistics` | Integer | Number of fouls against a team in a match |
| `yellow_cards` | `competitor` - `statistics` | Integer | Total team yellow cards for a match |
| `yellow_red_cards` | `competitor` - `statistics` | Integer | Total team red cards for a match which resulted from two yellow cards |
See our [FAQ](https://developer.sportradar.com/soccer/reference/soccer-extended-faq#lineups) for more information on lineups.
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `order` | `player` | Integer | Lineup position number for a player. See our [FAQ](https://developer.sportradar.com/soccer/reference/soccer-extended-faq#how-is-the-order-value-in-the-lineups-endpoint-organized) for detailed information on order numbers |
| `position` | `player` | Integer | Lineup position description (player tactical position) of a player for a match
`goalkeeper`, `right_back`, `central_defender`, `left_back`, `right_winger`, `central_midfielder`, `left_winger`, `striker`, `fullback` |
| `type` | `formation` | String | Team lineup formation for a match
ex. `4-3-3` or `4-2-3-1` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `capacity` | `venue` | Integer | Capacity of a venue
ex. `60000` |
| `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. `Liverpool` |
| `country_code` | `venue` | String | Country code of a venue
ex. `ENG` (England) |
| `country_name` | `venue` | String | Country name of a venue
ex. `England` |
| `id` | `venue` | String | Unique ID of a venue
ex. `sr:venue:579` |
| `map_coordinates` | `venue` | String | Coordinates of a venue
ex. `53.430622,-2.960919` |
| `name` | `venue` | String | Name of a venue
ex. `Anfield` |
| `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/London` |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "soccer-extended",
"version": "4"
},
"servers": [
{
"url": "https://api.sportradar.com/soccer-extended/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v4/{language_code}/sport_events/{sport_event_id}/lineups.{format}": {
"get": {
"summary": "Sport Event Lineups",
"description": "**Soccer Extended Sport Event Lineups** provides detailed roster information for a given match. Starting players, substitutions, formation type, and channel availability are included if supported by coverage level.",
"operationId": "soccer-extended-sport-event-lineups",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`trial`, `production`",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`da` (Danish), `de` (German), `el` (Greek), `en` (English), `es` (Spanish), `fi` (Finnish), `fr` (French), `id` (Indonesian), `it` (Italian), `ja` (Japanese), `nl` (Dutch), `pt` (Portuguese), `ru` (Russian), `sr` (Serbian), `srl` (Serbian Latin), `th` (Thai), `tr` (Turkish), `zh` (Chinese - simplified), `zht` (Chinese - traditional)
The above codes are the fully supported languages for this API. Click [here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx) for valid language codes and a tabular list of available languages per competition.",
"schema": {
"type": "string",
"enum": [
"da",
"de",
"el",
"en",
"es",
"fi",
"fr",
"id",
"it",
"ja",
"nl",
"pt",
"ru",
"sr",
"srl",
"th",
"tr",
"zh",
"zht"
],
"default": "en"
},
"required": true
},
{
"name": "sport_event_id",
"in": "path",
"description": "Unique Id of a sport event
**Example:** `sr:sport_event:50850733`",
"schema": {
"type": "string",
"default": "sr:sport_event:61300703"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": {
"generated_at": "2026-10-02T17:41:17.894Z",
"lineups": {
"competitors": [
{
"abbreviation": "string",
"age_group": "U23",
"country": "string",
"country_code": "string",
"formation": {
"type": "3-2-2-3"
},
"gender": "string",
"id": "string",
"jersey": {
"base": "string",
"horizontal_stripes": true,
"horizontal_stripes_color": "string",
"number": "string",
"shirt_type": "string",
"sleeve": "string",
"sleeve_detail": "string",
"split": true,
"split_color": "string",
"squares": true,
"squares_color": "string",
"stripes": true,
"stripes_color": "string",
"type": "string"
},
"manager": {
"country_code": "string",
"date_of_birth": "2026-10-02",
"gender": "female",
"id": "string",
"name": "string",
"nationality": "string",
"nickname": "string",
"place_of_birth": "string",
"preferred_foot": "right"
},
"name": "string",
"players": [
{
"captain": true,
"country_code": "string",
"country_of_birth": "string",
"date_of_birth": "2026-10-02",
"estimated_return_date": "2026-10-02T17:41:17.894Z",
"gender": "female",
"height": 0,
"id": "string",
"jersey_number": 0,
"loaned_to_competitor_id": "string",
"name": "string",
"nationality": "string",
"nickname": "string",
"on_loan": true,
"order": 0,
"place_of_birth": "string",
"played": true,
"position": "goalkeeper",
"preferred_foot": "right",
"starter": true,
"type": "goalkeeper",
"weight": 0
}
],
"qualifier": "string",
"virtual": true
}
]
},
"sport_event": {
"channels": [
{
"country": "string",
"country_code": "string",
"name": "string",
"url": "string"
}
],
"competitors": [
{
"abbreviation": "string",
"age_group": "U23",
"country": "string",
"country_code": "string",
"form": "string",
"gender": "string",
"id": "string",
"name": "string",
"other_season_id": "string",
"qualifier": "home",
"short_name": "string",
"virtual": true
}
],
"coverage": {
"competition_properties": {
"brackets": true,
"is_friendly": true,
"missing_players": true,
"player_transfer_history": true,
"schedules": true,
"season_player_statistics": true,
"season_probabilities": true,
"season_stats_leaders": true,
"season_team_statistics": true,
"standings": "live",
"team_squads": true
},
"group_properties": {
"brackets": true,
"cup": true,
"group_stage": true,
"league": true,
"missing_players": true,
"qualification": true,
"results": true,
"schedules": true,
"standings": "live"
},
"sport_event_properties": {
"assists": true,
"ballspotting": true,
"basic_play_by_play": true,
"basic_player_stats": true,
"basic_team_stats": true,
"commentary": true,
"deeper_play_by_play": true,
"deeper_player_stats": true,
"deeper_team_stats": true,
"extended_play_by_play": true,
"extended_player_stats": true,
"extended_team_stats": true,
"formations": true,
"fun_facts": true,
"game_clock": true,
"goal_scorers": true,
"goal_scorers_live": true,
"lineups": true,
"lineups_availability": "pre",
"probabilities": true,
"scores": "live",
"venue": true
},
"type": "sport_event"
},
"date_confirmed": true,
"id": "sr:sport_event:79348345847239073392448884854346930974",
"replaced_by": "sr:sport_event:4546130",
"resume_time": "2026-10-02T17:41:17.894Z",
"sport_event_conditions": {
"attendance": {
"count": 0
},
"comment": {
"text": "string"
},
"ground": {
"neutral": true
},
"lineups": {
"confirmed": true
},
"referees": [
{
"country_code": "string",
"id": "string",
"name": "string",
"nationality": "string",
"type": "first_assistant_referee"
}
],
"weather": {
"overall_conditions": "good",
"pitch_conditions": "good"
}
},
"sport_event_context": {
"category": {
"country_code": "string",
"id": "string",
"name": "string"
},
"competition": {
"alternative_name": "string",
"gender": "string",
"id": "string",
"name": "string",
"parent_id": "string",
"type": "string"
},
"groups": [
{
"group_name": "string",
"id": "string",
"name": "string"
}
],
"round": {
"competition_sport_event_number": 0,
"cup_round_id": "string",
"cup_round_number_of_sport_events": 0,
"cup_round_sport_event_number": 0,
"name": "string",
"number": 0,
"other_sport_event_id": "sr:sport_event:16058931533382452794799026229758169"
},
"season": {
"competition_id": "string",
"disabled": true,
"end_date": "2026-10-02",
"id": "string",
"name": "string",
"start_date": "2026-10-02",
"year": "string"
},
"sport": {
"id": "string",
"name": "string"
},
"stage": {
"end_date": "2026-10-02",
"order": 0,
"phase": "stage_1_playoff",
"start_date": "2026-10-02",
"type": "cup",
"year": "string"
}
},
"start_time": "2026-10-02T17:41:17.894Z",
"start_time_confirmed": true,
"venue": {
"capacity": 0,
"changed": true,
"city_id": "string",
"city_name": "string",
"country_code": "string",
"country_name": "string",
"id": "string",
"map_coordinates": "string",
"name": "string",
"reduced_capacity": true,
"reduced_capacity_max": 0,
"timezone": "string"
}
},
"sport_event_status": {
"aggregate_away_score": 0,
"aggregate_home_score": 0,
"aggregate_winner_id": "sr:competitor:0576501087450017941601525776142606461332495712655498315948651588237833640",
"away_normaltime_score": 0,
"away_overtime_score": 0,
"away_score": 0,
"ball_locations": [
{
"order": 1,
"qualifier": "home",
"x": 35,
"y": 48
}
],
"clock": {
"played": "string",
"stoppage_time_announced": "string",
"stoppage_time_played": "string"
},
"decided_by_fed": true,
"home_normaltime_score": 0,
"home_overtime_score": 0,
"home_score": 0,
"match_situation": {
"qualifier": "home",
"status": "safe",
"updated_at": "2026-10-02T17:41:17.895Z"
},
"match_status": "not_started",
"match_tie": true,
"period_scores": [
{
"away_score": 0,
"home_score": 0,
"number": 0,
"type": "regular_period"
}
],
"scout_abandoned": true,
"status": "not_started",
"winner_id": "string"
}
}
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2026-10-02T17:41:17.894Z"
},
"lineups": {
"type": "object",
"properties": {
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"age_group": {
"type": "string",
"example": "U23"
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"formation": {
"type": "object",
"properties": {
"type": {
"type": "string",
"example": "3-2-2-3"
}
}
},
"gender": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"jersey": {
"type": "object",
"properties": {
"base": {
"type": "string",
"example": "string"
},
"horizontal_stripes": {
"type": "boolean",
"example": true,
"default": true
},
"horizontal_stripes_color": {
"type": "string",
"example": "string"
},
"number": {
"type": "string",
"example": "string"
},
"shirt_type": {
"type": "string",
"example": "string"
},
"sleeve": {
"type": "string",
"example": "string"
},
"sleeve_detail": {
"type": "string",
"example": "string"
},
"split": {
"type": "boolean",
"example": true,
"default": true
},
"split_color": {
"type": "string",
"example": "string"
},
"squares": {
"type": "boolean",
"example": true,
"default": true
},
"squares_color": {
"type": "string",
"example": "string"
},
"stripes": {
"type": "boolean",
"example": true,
"default": true
},
"stripes_color": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "string"
}
}
},
"manager": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"date_of_birth": {
"type": "string",
"example": "2026-10-02"
},
"gender": {
"type": "string",
"example": "female"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"nationality": {
"type": "string",
"example": "string"
},
"nickname": {
"type": "string",
"example": "string"
},
"place_of_birth": {
"type": "string",
"example": "string"
},
"preferred_foot": {
"type": "string",
"example": "right"
}
}
},
"name": {
"type": "string",
"example": "string"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"captain": {
"type": "boolean",
"example": true,
"default": true
},
"country_code": {
"type": "string",
"example": "string"
},
"country_of_birth": {
"type": "string",
"example": "string"
},
"date_of_birth": {
"type": "string",
"example": "2026-10-02"
},
"estimated_return_date": {
"type": "string",
"example": "2026-10-02T17:41:17.894Z"
},
"gender": {
"type": "string",
"example": "female"
},
"height": {
"type": "integer",
"example": 0,
"default": 0
},
"id": {
"type": "string",
"example": "string"
},
"jersey_number": {
"type": "integer",
"example": 0,
"default": 0
},
"loaned_to_competitor_id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"nationality": {
"type": "string",
"example": "string"
},
"nickname": {
"type": "string",
"example": "string"
},
"on_loan": {
"type": "boolean",
"example": true,
"default": true
},
"order": {
"type": "integer",
"example": 0,
"default": 0
},
"place_of_birth": {
"type": "string",
"example": "string"
},
"played": {
"type": "boolean",
"example": true,
"default": true
},
"position": {
"type": "string",
"example": "goalkeeper"
},
"preferred_foot": {
"type": "string",
"example": "right"
},
"starter": {
"type": "boolean",
"example": true,
"default": true
},
"type": {
"type": "string",
"example": "goalkeeper"
},
"weight": {
"type": "integer",
"example": 0,
"default": 0
}
}
}
},
"qualifier": {
"type": "string",
"example": "string"
},
"virtual": {
"type": "boolean",
"example": true,
"default": true
}
}
}
}
}
},
"sport_event": {
"type": "object",
"properties": {
"channels": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"url": {
"type": "string",
"example": "string"
}
}
}
},
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"age_group": {
"type": "string",
"example": "U23"
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"form": {
"type": "string",
"example": "string"
},
"gender": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"other_season_id": {
"type": "string",
"example": "string"
},
"qualifier": {
"type": "string",
"example": "home"
},
"short_name": {
"type": "string",
"example": "string"
},
"virtual": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"coverage": {
"type": "object",
"properties": {
"competition_properties": {
"type": "object",
"properties": {
"brackets": {
"type": "boolean",
"example": true,
"default": true
},
"is_friendly": {
"type": "boolean",
"example": true,
"default": true
},
"missing_players": {
"type": "boolean",
"example": true,
"default": true
},
"player_transfer_history": {
"type": "boolean",
"example": true,
"default": true
},
"schedules": {
"type": "boolean",
"example": true,
"default": true
},
"season_player_statistics": {
"type": "boolean",
"example": true,
"default": true
},
"season_probabilities": {
"type": "boolean",
"example": true,
"default": true
},
"season_stats_leaders": {
"type": "boolean",
"example": true,
"default": true
},
"season_team_statistics": {
"type": "boolean",
"example": true,
"default": true
},
"standings": {
"type": "string",
"example": "live"
},
"team_squads": {
"type": "boolean",
"example": true,
"default": true
}
}
},
"group_properties": {
"type": "object",
"properties": {
"brackets": {
"type": "boolean",
"example": true,
"default": true
},
"cup": {
"type": "boolean",
"example": true,
"default": true
},
"group_stage": {
"type": "boolean",
"example": true,
"default": true
},
"league": {
"type": "boolean",
"example": true,
"default": true
},
"missing_players": {
"type": "boolean",
"example": true,
"default": true
},
"qualification": {
"type": "boolean",
"example": true,
"default": true
},
"results": {
"type": "boolean",
"example": true,
"default": true
},
"schedules": {
"type": "boolean",
"example": true,
"default": true
},
"standings": {
"type": "string",
"example": "live"
}
}
},
"sport_event_properties": {
"type": "object",
"properties": {
"assists": {
"type": "boolean",
"example": true,
"default": true
},
"ballspotting": {
"type": "boolean",
"example": true,
"default": true
},
"basic_play_by_play": {
"type": "boolean",
"example": true,
"default": true
},
"basic_player_stats": {
"type": "boolean",
"example": true,
"default": true
},
"basic_team_stats": {
"type": "boolean",
"example": true,
"default": true
},
"commentary": {
"type": "boolean",
"example": true,
"default": true
},
"deeper_play_by_play": {
"type": "boolean",
"example": true,
"default": true
},
"deeper_player_stats": {
"type": "boolean",
"example": true,
"default": true
},
"deeper_team_stats": {
"type": "boolean",
"example": true,
"default": true
},
"extended_play_by_play": {
"type": "boolean",
"example": true,
"default": true
},
"extended_player_stats": {
"type": "boolean",
"example": true,
"default": true
},
"extended_team_stats": {
"type": "boolean",
"example": true,
"default": true
},
"formations": {
"type": "boolean",
"example": true,
"default": true
},
"fun_facts": {
"type": "boolean",
"example": true,
"default": true
},
"game_clock": {
"type": "boolean",
"example": true,
"default": true
},
"goal_scorers": {
"type": "boolean",
"example": true,
"default": true
},
"goal_scorers_live": {
"type": "boolean",
"example": true,
"default": true
},
"lineups": {
"type": "boolean",
"example": true,
"default": true
},
"lineups_availability": {
"type": "string",
"example": "pre"
},
"probabilities": {
"type": "boolean",
"example": true,
"default": true
},
"scores": {
"type": "string",
"example": "live"
},
"venue": {
"type": "boolean",
"example": true,
"default": true
}
}
},
"type": {
"type": "string",
"example": "sport_event"
}
}
},
"date_confirmed": {
"type": "boolean",
"example": true,
"default": true
},
"id": {
"type": "string",
"example": "sr:sport_event:79348345847239073392448884854346930974"
},
"replaced_by": {
"type": "string",
"example": "sr:sport_event:4546130"
},
"resume_time": {
"type": "string",
"example": "2026-10-02T17:41:17.894Z"
},
"sport_event_conditions": {
"type": "object",
"properties": {
"attendance": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 0,
"default": 0
}
}
},
"comment": {
"type": "object",
"properties": {
"text": {
"type": "string",
"example": "string"
}
}
},
"ground": {
"type": "object",
"properties": {
"neutral": {
"type": "boolean",
"example": true,
"default": true
}
}
},
"lineups": {
"type": "object",
"properties": {
"confirmed": {
"type": "boolean",
"example": true,
"default": true
}
}
},
"referees": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"nationality": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "first_assistant_referee"
}
}
}
},
"weather": {
"type": "object",
"properties": {
"overall_conditions": {
"type": "string",
"example": "good"
},
"pitch_conditions": {
"type": "string",
"example": "good"
}
}
}
}
},
"sport_event_context": {
"type": "object",
"properties": {
"category": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"competition": {
"type": "object",
"properties": {
"alternative_name": {
"type": "string",
"example": "string"
},
"gender": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"parent_id": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "string"
}
}
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"group_name": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
}
},
"round": {
"type": "object",
"properties": {
"competition_sport_event_number": {
"type": "integer",
"example": 0,
"default": 0
},
"cup_round_id": {
"type": "string",
"example": "string"
},
"cup_round_number_of_sport_events": {
"type": "integer",
"example": 0,
"default": 0
},
"cup_round_sport_event_number": {
"type": "integer",
"example": 0,
"default": 0
},
"name": {
"type": "string",
"example": "string"
},
"number": {
"type": "integer",
"example": 0,
"default": 0
},
"other_sport_event_id": {
"type": "string",
"example": "sr:sport_event:16058931533382452794799026229758169"
}
}
},
"season": {
"type": "object",
"properties": {
"competition_id": {
"type": "string",
"example": "string"
},
"disabled": {
"type": "boolean",
"example": true,
"default": true
},
"end_date": {
"type": "string",
"example": "2026-10-02"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"start_date": {
"type": "string",
"example": "2026-10-02"
},
"year": {
"type": "string",
"example": "string"
}
}
},
"sport": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"stage": {
"type": "object",
"properties": {
"end_date": {
"type": "string",
"example": "2026-10-02"
},
"order": {
"type": "integer",
"example": 0,
"default": 0
},
"phase": {
"type": "string",
"example": "stage_1_playoff"
},
"start_date": {
"type": "string",
"example": "2026-10-02"
},
"type": {
"type": "string",
"example": "cup"
},
"year": {
"type": "string",
"example": "string"
}
}
}
}
},
"start_time": {
"type": "string",
"example": "2026-10-02T17:41:17.894Z"
},
"start_time_confirmed": {
"type": "boolean",
"example": true,
"default": true
},
"venue": {
"type": "object",
"properties": {
"capacity": {
"type": "integer",
"example": 0,
"default": 0
},
"changed": {
"type": "boolean",
"example": true,
"default": true
},
"city_id": {
"type": "string",
"example": "string"
},
"city_name": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"country_name": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"map_coordinates": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"reduced_capacity": {
"type": "boolean",
"example": true,
"default": true
},
"reduced_capacity_max": {
"type": "integer",
"example": 0,
"default": 0
},
"timezone": {
"type": "string",
"example": "string"
}
}
}
}
},
"sport_event_status": {
"type": "object",
"properties": {
"aggregate_away_score": {
"type": "integer",
"example": 0,
"default": 0
},
"aggregate_home_score": {
"type": "integer",
"example": 0,
"default": 0
},
"aggregate_winner_id": {
"type": "string",
"example": "sr:competitor:0576501087450017941601525776142606461332495712655498315948651588237833640"
},
"away_normaltime_score": {
"type": "integer",
"example": 0,
"default": 0
},
"away_overtime_score": {
"type": "integer",
"example": 0,
"default": 0
},
"away_score": {
"type": "integer",
"example": 0,
"default": 0
},
"ball_locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"order": {
"type": "integer",
"example": 1,
"default": 0
},
"qualifier": {
"type": "string",
"example": "home"
},
"x": {
"type": "integer",
"example": 35,
"default": 0
},
"y": {
"type": "integer",
"example": 48,
"default": 0
}
}
}
},
"clock": {
"type": "object",
"properties": {
"played": {
"type": "string",
"example": "string"
},
"stoppage_time_announced": {
"type": "string",
"example": "string"
},
"stoppage_time_played": {
"type": "string",
"example": "string"
}
}
},
"decided_by_fed": {
"type": "boolean",
"example": true,
"default": true
},
"home_normaltime_score": {
"type": "integer",
"example": 0,
"default": 0
},
"home_overtime_score": {
"type": "integer",
"example": 0,
"default": 0
},
"home_score": {
"type": "integer",
"example": 0,
"default": 0
},
"match_situation": {
"type": "object",
"properties": {
"qualifier": {
"type": "string",
"example": "home"
},
"status": {
"type": "string",
"example": "safe"
},
"updated_at": {
"type": "string",
"example": "2026-10-02T17:41:17.895Z"
}
}
},
"match_status": {
"type": "string",
"example": "not_started"
},
"match_tie": {
"type": "boolean",
"example": true,
"default": true
},
"period_scores": {
"type": "array",
"items": {
"type": "object",
"properties": {
"away_score": {
"type": "integer",
"example": 0,
"default": 0
},
"home_score": {
"type": "integer",
"example": 0,
"default": 0
},
"number": {
"type": "integer",
"example": 0,
"default": 0
},
"type": {
"type": "string",
"example": "regular_period"
}
}
}
},
"scout_abandoned": {
"type": "boolean",
"example": true,
"default": true
},
"status": {
"type": "string",
"example": "not_started"
},
"winner_id": {
"type": "string",
"example": "string"
}
}
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```