---
updatedAt: 2026-07-28T07:22:24.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/soccer/llms.txt
---

# League Timeline

Provides an alternate set of statistics for an event which match official league sites.<br><br>Official stats are provided for: England Premier League, Germany Bundesliga, Italy Serie A, Spain La Liga, UEFA Champions League, USA MLS, Austria Bundesliga.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  300s Time To Live / Cache
</Callout>

> 📘 Tracking a Single Match
>
> Learn how match statistics aligned with official league sites fit into match coverage in our [Live Match Updates](https://developer.sportradar.com/soccer/docs/soccer-ig-live-match-retrieval) integration scenario.

***

## Data Points

<Accordion title="Category & Sport" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country_code` | `sport_event_context` - `category` | String | Country code for a sport event's category<br /><br />ex. `ENG` (England) |
| `id` | `sport_event_context` - `category` | String | Unique category ID for a sport event<br /><br />ex. `sr:category:1` |
| `name` | `sport_event_context` - `category` | String | Name for a sport event's category<br /><br />ex. `England` (Premier League) |
| `id` | `sport_event_context` - `sport` | String | Unique sport ID for a sport event<br /><br />ex. `sr:sport:1` |
| `name` | `sport_event_context` - `sport` | String | Name for a sport event's sport<br /><br />ex. `Soccer` |

</Accordion>

<Accordion title="Competition" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `alternative_name` | `sport_event_context` - `competition` | String | Alternate name of a competition<br /><br />ex. `English Premier League` (instead of `Premier League`) |
| `gender` | `sport_event_context` - `competition` | String | Gender for a competition<br /><br />ex. `men` |
| `id` | `sport_event_context` - `competition` | String | Unique ID for a competition<br /><br />ex. `sr:competition:17` (Premier League) |
| `name` | `sport_event_context` - `competition` | String | Name of a competition<br /><br />ex. `Premier League` |
| `parent_id` | `sport_event_context` - `competition` | String | Unique parent ID for a competition. Typically present for group stage or playoff competitions <br /><br />ex. `sr:competition:945` used to link competitions together, like the World Cup and the various qualifiers. |

</Accordion>

<Accordion title="Groups, Rounds, Seasons, & Stages" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `sport_event_context` - `groups` - `group` | String | Unique ID for a sport event's group<br /><br />ex. `sr:league:80253` (UEFA Euro 2024, Group D) |
| `name` | `sport_event_context` - `groups` - `group` | String | Name of a sport event's group<br /><br />ex. `UEFA Euro 2024, Group D` |
| `group_name` | `sport_event_context` - `groups` - `group` | String | Abbreviated name of a sport event's group<br /><br />ex. `D` |
| `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<br /><br />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<br /><br />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<br /><br />ex. `sr:sport_event:47395897` |
| `competition_id` | `sport_event_context` - `season` | String | Unique ID for the competition a sport event belongs to<br /><br />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<br /><br />ex. `2024-05-19` |
| `id` | `sport_event_context` - `season` | String | Unique ID for a sport event's season<br /><br />ex. `sr:season:105353` (Premier League 23/24) |
| `name` | `sport_event_context` - `season` | String | Name of a sport event's season<br /><br />ex. `Premier League 23/24` |
| `start_date` | `sport_event_context` - `season` | Date | Start date of a sport event's season<br /><br />ex. `2023-08-11` |
| `year` | `sport_event_context` - `season` | String | Year of a sport event's season<br /><br />ex. `23/24` |
| `end_date` | `sport_event_context` - `stage` | Date | End date of a sport event's stage<br /><br />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<br /><br />ex. `regular season`, `preliminary_round`, `qualification` |
| `start_date` | `sport_event_context` - `stage` | Date | Start date of a sport event's stage<br /><br />ex. `2023-08-11` |
| `type` | `sport_event_context` - `stage` | String | Type of a sport event's stage<br /><br />`cup`, `league` |
| `year` | `sport_event_context` - `stage` | String | Year of a sport event's stage<br /><br />ex. `23/24` |

</Accordion>

<Accordion title="Competitor" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `abbreviation` | `competitors` - `competitor` | String | Abbreviation for a competitor name<br /><br />ex. `LIV` (Liverpool FC) |
| `age_group` | `competitors` - `competitor` | String | Age group of a competitor, when applicable<br /><br />ex. `U23` |
| `country` | `competitors` - `competitor` | String | Country of a competitor<br /><br />ex. `England` |
| `country_code` | `competitors` - `competitor` | String | Country code of a competitor<br /><br />ex. `ENG` (England) |
| `gender` | `competitors` - `competitor` | String | Gender for a competitor<br /><br />`male`, `female` |
| `id` | `competitors` - `competitor` | String | Unique ID for a competitor<br /><br />ex. `sr:competitor:44` (Liverpool FC) |
| `name` | `competitors` - `competitor` | String | Name for a competitor<br /><br />ex. `Liverpool FC` |
| `qualifier` | `competitors` - `competitor` | String | Designation of a competitor for a sport event<br /><br />`home`, `away` |
| `virtual` | `competitors` - `competitor` | Boolean | Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups. |

</Accordion>

<Accordion title="Player" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `statistics` - `competitor` - `player` | String | Unique ID of a player<br /><br />ex. `sr:player:159665` |
| `name` | `statistics` - `competitor` - `player` | String | Name of a player<br /><br />ex. `Salah, Mohamed` |
| `starter` | `statistics` - `competitor` - `player` | Boolean | Signifies a player is in the starting lineup for a sport event when `true` |

</Accordion>

<Accordion title="Sport Event" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `count` | `sport_event_conditions` - `attendance` | Integer | Attendance for a sport event<br /><br />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<br /><br />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<br /><br />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<br /><br />ex. `2024-03-26T20:00:00+00:00` |
| `start_time` | `sport_event` | Date | Start time of a sport event<br /><br />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<br /><br />`good`, `medium`, `bad`, `indoor`, `extreme` |
| `pitch_conditions` | `sport_event_conditions` - `weather` | String | Pitch conditions for a sport event<br /><br />`good`, `medium`, `bad` |

</Accordion>

<Accordion title="Sport Event - Channel" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country` | `sport_event` - `channels` - `channel` | String | Country of a broadcast channel<br /><br />ex. `United States` |
| `country_code` | `sport_event` - `channels` - `channel` | String | Country code of a broadcast channel<br /><br />ex. `USA` |
| `name` | `sport_event` - `channels` - `channel` | String | Name of a broadcast channel<br /><br />ex. `Fox Soccer Plus` |
| `url` | `sport_event` - `channels` - `channel` | String | URL of a broadcast channel |

</Accordion>

<Accordion title="Sport Event - Referee" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `sport_event_conditions` - `referees` - `referee` | String | Unique ID for a referee<br /><br />ex. `sr:referee:229470` |
| `name` | `sport_event_conditions` - `referees` - `referee` | String | Name of a referee<br /><br />ex. `Brooks, John` |
| `nationality` | `sport_event_conditions` - `referees` - `referee` | String | Nationality of a referee<br /><br />ex. `England` |
| `country_code` | `sport_event_conditions` - `referees` - `referee` | String | Country code of a referee<br /><br />ex. `ENG` |
| `type` | `sport_event_conditions` - `referees` - `referee` | String | Type of a referee<br /><br />ex. `first_assistant_referee`, `second_assistant_referee`, `fourth_official`, `video_assistant_referee`, `first_additional_assistant`, `second_additional_assistant`, `main_referee` |

</Accordion>

<Accordion title="Sport Event - Coverage Properties" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `type` | `sport_event` - `coverage` | String | Type of coverage<br /><br />`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 in the [Soccer Extended API](https://developer.sportradar.com/soccer/reference/soccer-extended-sport-event-extended-timeline) for a sport event when `true` |
| `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` |
| `fun_facts` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies fun facts are 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` |
| `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<br /><br />`pre`, `post` |
| `probabilities` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies probabilities are available for a sport event when `true`<br /><br /><i><b>Note:</b> Attribute is not currently supported</i> |
| `scores` | `sport_event` - `coverage` - `sport_event_properties` | String | Describes the availability of scores as live or post-match<br /><br />`live`, `post` |
| `venue` | `sport_event` - `coverage` - `sport_event_properties` | Boolean | Signifies venue info is available for a sport event when `true` |

</Accordion>

<Accordion title="Sport Event Situation" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `played` | `sport_event_status` - `clock` | String | Match clock time in minutes<br /><br />`90:00` |
| `stoppage_time_played` | `sport_event_status` - `clock` | String | Stoppage time played in minutes<br /><br />`5:49` |
| `stoppage_time_announced` | `sport_event_status` - `clock` | String | Stoppage time announced in minutes<br /><br />`5:00` |
| `status` | `sport_event_status` - `match_situation` | String | Current situation status of a match<br /><br />`safe`, `dangerous`, `attack` |
| `qualifier` | `sport_event_status` - `match_situation` | String | Defines the team in the current situation status<br /><br />`home`, `away` |
| `updated_at` | `sport_event_status` - `match_situation` | Date-Time | Timestamp of the most recent match situation update<br /><br />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<br /><br />`regular_period`, `overtime`, `penalties`, `pause`, `awaiting_extra`, `extra_time_halftime`, `interrupted` |

</Accordion>

<Accordion title="Sport Event Status" icon="fa-duotone fa-thin fa-futbol">

| 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<br /><br />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`<br /><br />ex. `not_started`, `2nd_half`, `ended`, `awaiting_penalties`<br /><br />See our [FAQ](https://developer.sportradar.com/soccer/reference/soccer-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<br /><br />ex. `not_started`, `live`, `ended`, `awaiting_penalties`<br /><br />See our [FAQ](https://developer.sportradar.com/soccer/reference/soccer-faq#sport-statuses) for a complete list of statuses and their definitions. |
| `winner_id`            | `sport_event_status` | String  | Unique ID of the match winner<br /><br />ex. `sr:competitor:44` |

</Accordion>

<Accordion title="Ball Location" icon="fa-duotone fa-thin fa-futbol">

> Visit our [FAQ](https://developer.sportradar.com/soccer/reference/soccer-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<br /><br />`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. |

</Accordion>

<Accordion title="Match Timeline" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
|-----------|----------------|------|-------------|
| `away_score` | `league_timeline` - `event` | Integer | Score for the away team after a timeline event |
| `break_name` | `league_timeline` - `event` | String | Brief description of a break event<br /><br />ex. `pause` |
| `card_description` | `league_timeline` - `event` | String | Description of the scenario during a card event<br /><br />ex. `pre_match`, `half_time`, `post_match`, `player_on_bench`, `first_half`, `second_half`, `during_penalty_shootout` |
| `text` | `league_timeline` - `event` - `commentary` | String | Commentary text description of a timeline event<br /><br />ex. `Mario Hermoso (Atletico) has received a yellow card from Slavko Vincic.` or `It's a goal kick for the home team in Dortmund.` |
| `competitor` | `league_timeline` - `event` | String | Designation of a competitor for a timeline event, `home` or `away` |
| `description` | `league_timeline` - `event` | String | Description of an event. *This data point is not currently in use* |
| `home_score` | `league_timeline` - `event` | Integer | Score for the home team after a timeline event |
| `id` | `league_timeline` - `event` | Integer | Unique ID for a timeline event<br /><br />ex. `1721786685` |
| `injury_time_announced` | `league_timeline` - `event` | Integer | Amount of injury time announced in minutes |
| `late` | `league_timeline` - `event` | Boolean | Indicates the incoming substitute was temporarily prevented from entering the field because the replaced player did not leave the field within the time allowed. When `true`, the team briefly plays with one fewer player before the substitution is completed. |
| `match_clock` | `league_timeline` - `event` | String | Match clock value for a timeline event, in minutes and seconds<br /><br />ex. `89:37` |
| `match_time` | `league_timeline` - `event` | Integer | Match clock value of a timeline event in minutes<br /><br />ex. `89` |
| `method` | `league_timeline` - `event` | String | Method of a scored goal<br /><br />ex. `penalty`, `own_goal`, `header`, `shot`, `free_kick` |
| `outcome` | `league_timeline` - `event` | String | Outcome of a missed goal<br /><br />ex. `miss`, `post`, `bar` |
| `period` | `league_timeline` - `event` | Integer | Period number of a timeline event |
| `period_name` | `league_timeline` - `event` | String | Period name of a timeline event, appearing at the beginning of a period<br /><br />ex. `regular_period` |
| `period_type` | `league_timeline` - `event` | String | Period type of a timeline event<br /><br />ex. `regular_period`, `overtime`, `penalties`, `pause`, `awaiting_extra`, `extra_time_halftime`, `interrupted` |
| `shootout_away_score` | `league_timeline` - `event` | Integer | Away team shootout score after a timeline event |
| `shootout_home_score` | `league_timeline` - `event` | Integer | Home team shootout score after a timeline event |
| `status` | `league_timeline` - `event` | String | Status available during penalty shootouts (`period_type="penalties"`)<br /><br />ex. `missed`, `scored`, `not_taken_yet` |
| `stoppage_time` | `league_timeline` - `event` | Integer | Stoppage time value for a timeline event<br /><br />ex. `3` |
| `stoppage_time_clock` | `league_timeline` - `event` | String | Stoppage time clock value for a timeline event<br /><br />ex. `2:03` |
| `type` | `league_timeline` - `event` | String | Type of timeline event. See [FAQ](https://developer.sportradar.com/soccer/reference/soccer-faq#event--period-types) for a complete list of event types<br /><br />ex. `goal_kick`, `period_start`, `yellow_card` |
| `time` | `league_timeline` - `event` | Date-time | UTC timestamp indicating when the timeline event was created or most recently updated in our system. This reflects system processing time, not the time the event occurred on the pitch. The timestamp may lag behind the actual event—typically by a short interval during live play, or by minutes to hours for later additions and corrections.<br /><br />When the record is first created, this value reflects its creation time. If the record is later updated, the value is replaced with the latest update time and no longer preserves the original creation time.<br /><br />ex. `2024-04-16T20:49:49+00:00` |
| `x` | `league_timeline` - `event` | Integer | Horizontal X coordinate of a timeline event, 0–100. Reference point 0 is at the home team’s goal. |
| `y` | `league_timeline` - `event` | Integer | Vertical Y coordinate of a timeline event, 0–100. Reference point 0 is on the top of the pitch where the home team’s goal is on the left-hand side. |

</Accordion>

<Accordion title="Player Event Details" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `event` - `player` | String | Unique player Id associated with a timeline event<br /><br />ex. `sr:player:2367105` |
| `name` | `event` - `player` | String | Player name associated with a timeline event<br /><br />ex. `Luna, Diego` |
| `type` | `event` - `player` | String | Player activity type associated with a timeline event. Signifies if a player scored a goal, recorded an assist, or participated in a substitution.<br /><br />ex. `scorer`, `assist`, `substituted_in`, `substituted_out` |

</Accordion>

<Accordion title="Match Stats (Player)" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `assists` | `player` - `statistics` | Integer | Player assists for a match |
| `corner_kicks` | `player` - `statistics` | Integer | Player corner kicks for a match |
| `goals` | `player` - `statistics` | Integer | Player goals scored for a match |
| `offsides` | `player` - `statistics` | Integer | Player offsides for a match |
| `own_goals` | `player` - `statistics` | Integer | Player own goals for a match |
| `red_cards` | `player` - `statistics` | Integer | Player red cards 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` |
| `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 |

</Accordion>

<Accordion title="Match Stats (Team)" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `assists` | `competitor` - `statistics` | Integer | Total team assists for a match |
| `corner_kicks` | `competitor` - `statistics` | Integer | Total team corner kicks for a match |
| `goals` | `competitor` - `statistics` | Integer | Team goals for a match |
| `red_cards` | `competitor` - `statistics` | Integer | Total team red cards for a match |
| `shots_on_goal` | `competitor` - `statistics` | Integer | Total team |
| shots on goal for a match | | | |
| `substitutions` | `competitor` - `statistics` | Integer | Total number player substitutions 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 |

</Accordion>

<Accordion title="Venue" icon="fa-duotone fa-thin fa-futbol">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `capacity` | `venue` | Integer | Capacity of a venue<br /><br />ex. `60000` |
| `changed` | `venue` | Boolean | Signifies a venue has been changed when `true` |
| `city_id` | `venue` | String | Unique ID of a city<br /><br />ex. `sr:city:59` |
| `city_name` | `venue` | String | City name of a venue<br /><br />ex. `Liverpool` |
| `country_code` | `venue` | String | Country code of a venue<br /><br />ex. `ENG` (England) |
| `country_name` | `venue` | String | Country name of a venue<br /><br />ex. `England` |
| `id` | `venue` | String | Unique ID of a venue<br /><br />ex. `sr:venue:579` |
| `map_coordinates` | `venue` | String | Coordinates of a venue<br /><br />ex. `53.430622,-2.960919` |
| `name` | `venue` | String | Name of a venue<br /><br />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<br /><br />ex. `Europe/London` |

</Accordion>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "soccer",
    "version": "4"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/soccer/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{access_level}/v4/{language_code}/sport_events/{sport_event_id}/league_timeline.{format}": {
      "get": {
        "summary": "League Timeline",
        "description": "Provides an alternate set of statistics for an event which match official league sites.<br><br>Official stats are provided for: England Premier League, Germany Bundesliga, Italy Serie A, Spain La Liga, UEFA Champions League, USA MLS, Austria Bundesliga.",
        "operationId": "soccer-league-timeline",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`trial`, `production`",
            "schema": {
              "type": "string",
              "enum": [
                "trial",
                "production"
              ],
              "default": "trial"
            },
            "required": true
          },
          {
            "name": "language_code",
            "in": "path",
            "description": "2-letter code for supported languages<br><br>`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)<br><br>The above codes are the fully supported languages for this API. Click <span style=\"text-decoration:underline\">[here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx)</span> 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<br><br>**Example:** `sr:sport_event:50850733`",
            "schema": {
              "type": "string",
              "default": "sr:sport_event:50850733"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`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-06-02T17:55:04.078Z",
                      "league_timeline": [
                        {
                          "action_type": "regular",
                          "additional_outcome": "hit_woodwork",
                          "away_score": 0,
                          "body_type": "left_foot",
                          "break_name": "string",
                          "card_description": "pre_match",
                          "commentaries": [
                            {
                              "text": "Its a goal kick for the away team in Manchester."
                            }
                          ],
                          "competitor": "home",
                          "corner_type": "short",
                          "counterattack": true,
                          "decision": "pending",
                          "description": "goal",
                          "destination_x": 0,
                          "destination_y": 0,
                          "direction": "forward",
                          "distance": 0,
                          "free_kick_type": "direct",
                          "goalface_x": 0,
                          "goalface_y": 0,
                          "home_score": 0,
                          "id": 0,
                          "in_penalty_area": true,
                          "injury_time_announced": 0,
                          "late": true,
                          "match_clock": "string",
                          "match_time": 0,
                          "method": "penalty",
                          "outcome": "bar",
                          "passing_range": "short",
                          "period": 0,
                          "period_name": "string",
                          "period_type": "regular_period",
                          "players": [
                            {
                              "competitor_id": "string",
                              "id": "string",
                              "name": "string",
                              "type": "shot_taker"
                            }
                          ],
                          "reason": "charge",
                          "shootout_away_score": 0,
                          "shootout_home_score": 0,
                          "status": "missed",
                          "stoppage_time": 0,
                          "stoppage_time_clock": "string",
                          "style": "inswing",
                          "time": "2026-06-02T17:55:04.078Z",
                          "trajectory": "flat",
                          "type": "break_start",
                          "type_of_play": "set_piece",
                          "updated": true,
                          "updated_start_time": "2026-06-02T17:55:04.078Z",
                          "updated_time": "2026-06-02T17:55:04.078Z",
                          "x": 0,
                          "xg_value": 0,
                          "y": 0
                        }
                      ],
                      "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,
                            "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:775375434",
                        "replaced_by": "sr:sport_event:605017190728880683995155181380776690",
                        "resume_time": "2026-06-02T17:55:04.078Z",
                        "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:0782285093177682"
                          },
                          "season": {
                            "competition_id": "string",
                            "disabled": true,
                            "end_date": "2026-06-02",
                            "id": "string",
                            "name": "string",
                            "start_date": "2026-06-02",
                            "year": "string"
                          },
                          "sport": {
                            "id": "string",
                            "name": "string"
                          },
                          "stage": {
                            "end_date": "2026-06-02",
                            "order": 0,
                            "phase": "stage_1_playoff",
                            "start_date": "2026-06-02",
                            "type": "cup",
                            "year": "string"
                          }
                        },
                        "start_time": "2026-06-02T17:55:04.078Z",
                        "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:1804356941026931992847888930116303",
                        "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-06-02T17:55:04.078Z"
                        },
                        "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"
                      },
                      "statistics": {
                        "competitors": [
                          {
                            "abbreviation": "string",
                            "age_group": "U23",
                            "country": "string",
                            "country_code": "string",
                            "form": "string",
                            "gender": "string",
                            "id": "string",
                            "name": "string",
                            "other_season_id": "string",
                            "players": [
                              {
                                "id": "string",
                                "name": "string",
                                "starter": true,
                                "statistics": {
                                  "assists": 0,
                                  "corner_kicks": 0,
                                  "fouls_suffered": 0,
                                  "goals": 0,
                                  "offsides": 0,
                                  "own_goals": 0,
                                  "red_cards": 0,
                                  "saves": 0,
                                  "shots": 0,
                                  "substituted_in": 0,
                                  "substituted_out": 0,
                                  "yellow_cards": 0,
                                  "yellow_red_cards": 0
                                }
                              }
                            ],
                            "qualifier": "home",
                            "short_name": "string",
                            "statistics": {
                              "assists": 0,
                              "ball_possessions": 0,
                              "blocked_shots": 0,
                              "corner_kicks": 0,
                              "fouls": 0,
                              "fouls_suffered": 0,
                              "goals": 0,
                              "offsides": 0,
                              "own_goals": 0,
                              "red_cards": 0,
                              "saves": 0,
                              "shots": 0,
                              "shots_off_goal": 0,
                              "shots_on_goal": 0,
                              "substitutions": 0,
                              "yellow_cards": 0,
                              "yellow_red_cards": 0
                            },
                            "virtual": true
                          }
                        ]
                      }
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "generated_at": {
                      "type": "string",
                      "example": "2026-06-02T17:55:04.078Z"
                    },
                    "league_timeline": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "action_type": {
                            "type": "string",
                            "example": "regular"
                          },
                          "additional_outcome": {
                            "type": "string",
                            "example": "hit_woodwork"
                          },
                          "away_score": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "body_type": {
                            "type": "string",
                            "example": "left_foot"
                          },
                          "break_name": {
                            "type": "string",
                            "example": "string"
                          },
                          "card_description": {
                            "type": "string",
                            "example": "pre_match"
                          },
                          "commentaries": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "text": {
                                  "type": "string",
                                  "example": "Its a goal kick for the away team in Manchester."
                                }
                              }
                            }
                          },
                          "competitor": {
                            "type": "string",
                            "example": "home"
                          },
                          "corner_type": {
                            "type": "string",
                            "example": "short"
                          },
                          "counterattack": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "decision": {
                            "type": "string",
                            "example": "pending"
                          },
                          "description": {
                            "type": "string",
                            "example": "goal"
                          },
                          "destination_x": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "destination_y": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "direction": {
                            "type": "string",
                            "example": "forward"
                          },
                          "distance": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "free_kick_type": {
                            "type": "string",
                            "example": "direct"
                          },
                          "goalface_x": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "goalface_y": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "home_score": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "id": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "in_penalty_area": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "injury_time_announced": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "late": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "match_clock": {
                            "type": "string",
                            "example": "string"
                          },
                          "match_time": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "method": {
                            "type": "string",
                            "example": "penalty"
                          },
                          "outcome": {
                            "type": "string",
                            "example": "bar"
                          },
                          "passing_range": {
                            "type": "string",
                            "example": "short"
                          },
                          "period": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "period_name": {
                            "type": "string",
                            "example": "string"
                          },
                          "period_type": {
                            "type": "string",
                            "example": "regular_period"
                          },
                          "players": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "competitor_id": {
                                  "type": "string",
                                  "example": "string"
                                },
                                "id": {
                                  "type": "string",
                                  "example": "string"
                                },
                                "name": {
                                  "type": "string",
                                  "example": "string"
                                },
                                "type": {
                                  "type": "string",
                                  "example": "shot_taker"
                                }
                              }
                            }
                          },
                          "reason": {
                            "type": "string",
                            "example": "charge"
                          },
                          "shootout_away_score": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "shootout_home_score": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "status": {
                            "type": "string",
                            "example": "missed"
                          },
                          "stoppage_time": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "stoppage_time_clock": {
                            "type": "string",
                            "example": "string"
                          },
                          "style": {
                            "type": "string",
                            "example": "inswing"
                          },
                          "time": {
                            "type": "string",
                            "example": "2026-06-02T17:55:04.078Z"
                          },
                          "trajectory": {
                            "type": "string",
                            "example": "flat"
                          },
                          "type": {
                            "type": "string",
                            "example": "break_start"
                          },
                          "type_of_play": {
                            "type": "string",
                            "example": "set_piece"
                          },
                          "updated": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "updated_start_time": {
                            "type": "string",
                            "example": "2026-06-02T17:55:04.078Z"
                          },
                          "updated_time": {
                            "type": "string",
                            "example": "2026-06-02T17:55:04.078Z"
                          },
                          "x": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "xg_value": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "y": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          }
                        }
                      }
                    },
                    "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
                                },
                                "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:775375434"
                        },
                        "replaced_by": {
                          "type": "string",
                          "example": "sr:sport_event:605017190728880683995155181380776690"
                        },
                        "resume_time": {
                          "type": "string",
                          "example": "2026-06-02T17:55:04.078Z"
                        },
                        "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:0782285093177682"
                                }
                              }
                            },
                            "season": {
                              "type": "object",
                              "properties": {
                                "competition_id": {
                                  "type": "string",
                                  "example": "string"
                                },
                                "disabled": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "end_date": {
                                  "type": "string",
                                  "example": "2026-06-02"
                                },
                                "id": {
                                  "type": "string",
                                  "example": "string"
                                },
                                "name": {
                                  "type": "string",
                                  "example": "string"
                                },
                                "start_date": {
                                  "type": "string",
                                  "example": "2026-06-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-06-02"
                                },
                                "order": {
                                  "type": "integer",
                                  "example": 0,
                                  "default": 0
                                },
                                "phase": {
                                  "type": "string",
                                  "example": "stage_1_playoff"
                                },
                                "start_date": {
                                  "type": "string",
                                  "example": "2026-06-02"
                                },
                                "type": {
                                  "type": "string",
                                  "example": "cup"
                                },
                                "year": {
                                  "type": "string",
                                  "example": "string"
                                }
                              }
                            }
                          }
                        },
                        "start_time": {
                          "type": "string",
                          "example": "2026-06-02T17:55:04.078Z"
                        },
                        "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:1804356941026931992847888930116303"
                        },
                        "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-06-02T17:55:04.078Z"
                            }
                          }
                        },
                        "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"
                        }
                      }
                    },
                    "statistics": {
                      "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"
                              },
                              "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"
                              },
                              "players": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "example": "string"
                                    },
                                    "name": {
                                      "type": "string",
                                      "example": "string"
                                    },
                                    "starter": {
                                      "type": "boolean",
                                      "example": true,
                                      "default": true
                                    },
                                    "statistics": {
                                      "type": "object",
                                      "properties": {
                                        "assists": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "corner_kicks": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "fouls_suffered": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "goals": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "offsides": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "own_goals": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "red_cards": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "saves": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "shots": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "substituted_in": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "substituted_out": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "yellow_cards": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        },
                                        "yellow_red_cards": {
                                          "type": "integer",
                                          "example": 0,
                                          "default": 0
                                        }
                                      }
                                    }
                                  }
                                }
                              },
                              "qualifier": {
                                "type": "string",
                                "example": "home"
                              },
                              "short_name": {
                                "type": "string",
                                "example": "string"
                              },
                              "statistics": {
                                "type": "object",
                                "properties": {
                                  "assists": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "ball_possessions": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "blocked_shots": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "corner_kicks": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "fouls": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "fouls_suffered": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "goals": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "offsides": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "own_goals": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "red_cards": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "saves": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "shots": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "shots_off_goal": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "shots_on_goal": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "substitutions": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "yellow_cards": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "yellow_red_cards": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  }
                                }
                              },
                              "virtual": {
                                "type": "boolean",
                                "example": true,
                                "default": true
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```