Change Log

Coverage Node Change

Release Date	Feeds Affected	Benefit
02/26/2024	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Made the following updates to coverage level properties. Removed the `live` attribute from the current `coverage` node and added  `type="sport_event"` Inserted a  `sport_event_properties` node into coverage  with the following attributes: - `basic_play_by_play` - `basic_player_stats` - `basic_team_stats` - `goal_scorers` - `lineups` - `scores` (`live` or `post`) Inserted a new coverage  node within the  `season_info` node between `season` and `stages` which contains  `type="competition"` Inserted a `competition_properties` node within `coverage` with the following attributes: - `brackets` - `schedules` - `standings`(`live`, `post`, `false`) - `team_squads`

<season_info
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="http://schemas.sportradar.com/sportsapi/handball/v2" generated_at="2024-02-23T17:21:11+00:00" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/handball/v2 https://d1woxfzdkvuts1.cloudfront.net/bsa-6558/handball/v2/schemas/season_info.xsd">
  <season id="sr:season:107903" name="Bundesliga 23/24" start_date="2023-08-24" end_date="2024-06-02" year="23/24" competition_id="sr:competition:149">
    <sport id="sr:sport:6" name="Handball"/>
    <category id="sr:category:53" name="Germany" country_code="DEU"/>
    <competition id="sr:competition:149" name="Bundesliga" gender="men"/>
  </season>
  <coverage type="competition">
    <competition_properties brackets="false" schedules="true" standings="live" team_squads="true"/>
    <sport_event_properties basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true" goal_scorers="true" lineups="true" scores="live"/>
  </coverage>
  <stages>
    <stage order="1" type="league" phase="regular season" start_date="2023-08-24" end_date="2024-06-02" year="23/24">
      <groups>
        <group id="sr:league:75771" name="Bundesliga 23/24" max_rounds="34">
          <competitors>
            <competitor id="sr:competitor:3982" name="SC Magdeburg" country="Germany" country_code="DEU" abbreviation="SCM" gender="male"/>
            <competitor id="sr:competitor:3993" name="SG Flensburg-Handewitt" country="Germany" country_code="DEU" abbreviation="SGF" gender="male"/>
            <competitor id="sr:competitor:3996" name="TBV Lemgo Lippe" country="Germany" country_code="DEU" abbreviation="TBV" gender="male"/>
            <competitor id="sr:competitor:3980" name="THW Kiel" country="Germany" country_code="DEU" abbreviation="THW" gender="male"/>
            <competitor id="sr:competitor:3994" name="VfL Gummersbach" country="Germany" country_code="DEU" abbreviation="GUM" gender="male"/>
            <competitor id="sr:competitor:3981" name="ThSV Eisenach" country="Germany" country_code="DEU" abbreviation="EIS" gender="male"/>
            <competitor id="sr:competitor:3984" name="HSG Wetzlar" country="Germany" country_code="DEU" abbreviation="WET" gender="male"/>
            <competitor id="sr:competitor:3995" name="FRISCH AUF! Goppingen" country="Germany" country_code="DEU" abbreviation="FAG" gender="male"/>
            <competitor id="sr:competitor:3997" name="HSV Hamburg" country="Germany" country_code="DEU" abbreviation="HSV" gender="male"/>
            <competitor id="sr:competitor:4004" name="Rhein-Neckar Lowen" country="Germany" country_code="DEU" abbreviation="RNL" gender="male"/>
            <competitor id="sr:competitor:4007" name="MT Melsungen" country="Germany" country_code="DEU" abbreviation="MTM" gender="male"/>
            <competitor id="sr:competitor:5463" name="HBW Balingen-Weilstetten" country="Germany" country_code="DEU" abbreviation="HBW" gender="male"/>
            <competitor id="sr:competitor:5453" name="Fuchse Berlin" country="Germany" country_code="DEU" abbreviation="BER" gender="male"/>
            <competitor id="sr:competitor:5447" name="TSV Hannover-Burgdorf" country="Germany" country_code="DEU" abbreviation="HAN" gender="male"/>
            <competitor id="sr:competitor:6268" name="Bergischer HC" country="Germany" country_code="DEU" abbreviation="BHC" gender="male"/>
            <competitor id="sr:competitor:6272" name="TVB Stuttgart" country="Germany" country_code="DEU" abbreviation="TVB" gender="male"/>
            <competitor id="sr:competitor:7962" name="SC DHfK Leipzig" country="Germany" country_code="DEU" abbreviation="LEI" gender="male"/>
            <competitor id="sr:competitor:6288" name="HC Erlangen" country="Germany" country_code="DEU" abbreviation="HCE" gender="male"/>
          </competitors>
        </group>
      </groups>
    </stage>
  </stages>
</season_info>

<sport_event_summary
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="http://schemas.sportradar.com/sportsapi/handball/v2" generated_at="2024-02-23T17:21:57+00:00" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/handball/v2 https://d1woxfzdkvuts1.cloudfront.net/bsa-6558/handball/v2/schemas/sport_event_summary.xsd">
  <sport_event id="sr:sport_event:44801036" start_time="2023-11-02T14:30:00+00:00" start_time_confirmed="true">
    <sport_event_context>
      <sport id="sr:sport:6" name="Handball"/>
      <category id="sr:category:73" name="International"/>
      <competition id="sr:competition:867" name="Int. Friendly Games" gender="men"/>
      <season id="sr:season:100945" name="Int. Friendly Games 2023" start_date="2023-01-01" end_date="2023-12-31" year="2023" competition_id="sr:competition:867"/>
      <stage order="1" type="league" phase="regular season" start_date="2023-01-01" end_date="2023-12-31" year="2023"/>
      <round number="1"/>
    </sport_event_context>
    <coverage type="sport_event">
      <sport_event_properties basic_play_by_play="false" basic_player_stats="false" basic_team_stats="false" goal_scorers="false" lineups="false" scores="live"/>
    </coverage>
    <competitors>
      <competitor id="sr:competitor:5593" name="Portugal" country="Portugal" country_code="PRT" abbreviation="POR" qualifier="home" gender="male"/>
      <competitor id="sr:competitor:22031" name="Austria" country="Austria" country_code="AUT" abbreviation="AUT" qualifier="away" gender="male"/>
    </competitors>
    <sport_event_conditions>
      <ground neutral="true"/>
    </sport_event_conditions>
  </sport_event>
  <sport_event_status status="closed" match_status="ended" home_score="27" away_score="34" winner_id="sr:competitor:22031">
    <period_scores>
      <period_score home_score="17" away_score="18" type="regular_period" number="1"/>
      <period_score home_score="10" away_score="16" type="regular_period" number="2"/>
    </period_scores>
  </sport_event_status>
</sport_event_summary>

Lineups Endpoints

Release Date	Feeds Affected	Benefit
02/26/2024	Season Lineups Sport Event Lineups	Added two RESTful endpoints: Season Lineups and Sport Event Lineups Season Lineups - Provides lineups for all matches in a given season. Sport Event Lineups - Provides detailed roster information for a given match. Starting players are indicated if supported by coverage level.

Pagination Update

Release Date	Feeds Affected	Benefit
11/27/2023	Season Summaries	Amended pagination from 200 to 100 events per request for the Season Summaries endpoint.

Goalkeeper Shots Saved

Release Date	Feeds Affected	Benefit
10/02/2023	Live Timelines Live Timelines Delta Sport Event Timeline	Added goalkeeper details on `shot_saved` events in the Timeline endpoints.

<event id="1541638431" type="shot_saved" time="2023-09-14T17:05:50+00:00" match_time="5" match_clock="4:54" competitor="home" shot_type="fast_break">
    <player id="sr:player:1591822" name="Horzen, Kristjan" type="shot"/>
    <players>
        <player id="sr:player:1591822" name="Horzen, Kristjan" type="shot"/>
        <player id="sr:player:905478" name="Johannesson, Peter" type="saved"/>
    </players>
</event>

{
    "id": 1541638431,
    "type": "shot_saved",
    "time": "2023-09-14T17:05:50+00:00",
    "match_time": 5,
    "match_clock": "4:54",
    "competitor": "home",
    "player": {
        "id": "sr:player:1591822",
        "name": "Horzen, Kristjan",
        "type": "shot"
    },
    "shot_type": "fast_break",
    "players": [
        {
            "id": "sr:player:1591822",
            "name": "Horzen, Kristjan",
            "type": "shot"
        },
        {
            "id": "sr:player:905478",
            "name": "Johannesson, Peter",
            "type": "saved"
        }
    ]
},

Round Info Additions

Date	Feeds Affected	Benefit
09/26/2023	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Added data points related to tournament rounds to bring consistency across APIs. New data points include: - Round - Cup Round Sport Event Number (`cup_round_sport_event_number`) - Round - Cup Round Number of Sport Events (`cup_round_number_of_sport_events`) - Round - Cup Round Id (`cup_round_id`) - Round - Other Sport Event Id (`other_sport_event_id`) *when 2 legs only

<round name="quarterfinal" other_sport_event_id="sr:sport_event:43573993" 
  cup_round_sport_event_number="2" cup_round_number_of_sport_events="2" 
  cup_round_id="sr:cup_round:1923693"/>

"round": {
    "name": "quarterfinal",
    "other_sport_event_id": "sr:sport_event:43573993",
    "cup_round_sport_event_number": 2,
    "cup_round_number_of_sport_events": 2,
    "cup_round_id": "sr:cup_round:1923693"
},

Event Types

Release Date	Feeds Affected	Benefit
09/21/2023	Live Timelines Live Timelines Delta Sport Event Timeline	Added two new event types:`empty_net` & `goalkeeper_back`. These signify when a goalkeeper is temporarily removed for an extra outfield player.

<event id="1541635889" type="empty_net" time="2023-09-14T17:02:06+00:00" 
    match_time="2" match_clock="1:11" competitor="away"/>
<event id="1541636501" type="technical_rule_fault" time="2023-09-14T17:03:04+00:00" 
    match_time="3" match_clock="2:06" competitor="away">
    <player id="sr:player:1028431" name="Babak, Tomas"/>
</event>
<event id="1541636509" type="goalkeeper_back" time="2023-09-14T17:03:04+00:00" 
    match_time="3" match_clock="2:10" competitor="away"/>

{
    "id": 1541635889,
    "type": "empty_net",
    "time": "2023-09-14T17:02:06+00:00",
    "match_time": 2,
    "match_clock": "1:11",
    "competitor": "away"
},
{
    "id": 1541636501,
    "type": "technical_rule_fault",
    "time": "2023-09-14T17:03:04+00:00",
    "match_time": 3,
    "match_clock": "2:06",
    "competitor": "away",
    "player": {
        "id": "sr:player:1028431",
        "name": "Babak, Tomas"
    }
},
{
    "id": 1541636509,
    "type": "goalkeeper_back",
    "time": "2023-09-14T17:03:04+00:00",
    "match_time": 3,
    "match_clock": "2:10",
    "competitor": "away"
},

Active Season Indicator

Release Date	Feeds Affected	Benefit
08/28/2023	Sport Events Created	Added a `active_season` attribute for newly created matches appearing in the Sport Events Created endpoint. When marked as `true` this will signify that an added match is part of an active season.

    <sport_event_created id="sr:sport_event:43393169" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
    <sport_event_created id="sr:sport_event:43393167" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
    <sport_event_created id="sr:sport_event:43393165" active_season="true" created_at="2023-08-30T14:42:38+00:00"/>
    <sport_event_created id="sr:sport_event:43393163" active_season="true" created_at="2023-08-30T14:42:37+00:00"/>
    <sport_event_created id="sr:sport_event:43393029" active_season="true" created_at="2023-08-30T14:37:40+00:00"/>

{
    "generated_at": "2023-08-30T14:47:30+00:00",
    "sport_events_created": [
        {
            "id": "sr:sport_event:43393169",
            "active_season": true,
            "created_at": "2023-08-30T14:42:39+00:00"
        },
        {
            "id": "sr:sport_event:43393167",
            "active_season": true,
            "created_at": "2023-08-30T14:42:39+00:00"
        },
        {
            "id": "sr:sport_event:43393165",
            "active_season": true,
            "created_at": "2023-08-30T14:42:38+00:00"
        },
        {
            "id": "sr:sport_event:43393163",
            "active_season": true,
            "created_at": "2023-08-30T14:42:37+00:00"
        },

'Season Form Standings' Endpoint

Release Date	Feeds Affected	Benefit
05/10/2023	Season Form Standings	Released a new Season Form Standings endpoint. This endpoint provides a form table of game results and splits for a given season. It can be leveraged to easily display the W/D/L (win/draw/loss) of each team's recent matches among a variety of splits (total, home, away, 1st half total, 1st half home, 1st half away).

Cup Round Data

Release Date	Feeds Affected	Benefit
03/20/2023	Season Links	Added `order`, `state`, and `winner_id` to cup rounds in the Season Links endpoint. These new fields can be leveraged to determine the status, order, and winner of a cup round within a season/tournament.

Age Group & Gender Additions

Release Date	Feeds Affected	Benefit
03/13/2023	Competitor Profile Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Profile Season Info Season Lineups Season Probabilities Season Standings Season Summaries Seasonal Competitor Statistics Sport Event Lineups Sport Event Summary Sport Event Timeline Push Statistics	Added `age_group` and `gender` to competitor elements in several endpoints. This update follows the existing format of the Soccer API, and will help to efficiently distinguish these competitor (team) characteristics.

Pagination Update to Season Probabilities

Release Date	Feeds Affected	Benefit
03/03/2023	Season Probabilities	Added pagination to the Season Probabilities endpoint for several APIs. Going forward, the first 200 events will be displayed. To retrieve further events additional query string parameters will be required. For example, to load the next 200 events you will need to append `&start=200` to the call and to load the next 200 add `&start=400` and so on.

Category Data

Release Date	Feeds Affected	Benefit
01/20/2023	Competition Info	Added the `category` element to the Competition Info endpoint. This includes category `id`, `name`, and `country_code`. The category will be represented by the country or `International` to better distinguish the country designation.

'updated' Attributes for Push Feeds

Release Date	Feeds Affected	Benefit
11/29/2022	Push Events	Added `updated` and `updated_time` flags to the Push Events feed. This update will better display which game events have been updated.

Season Links Endpoint

Release Date	Feeds Affected	Benefit
10/04/2022	Season Links	Added data points to support the new Season Links endpoint. This feed can be used to compile advancement brackets for relevant seasons.

'Competitor Merge Mappings' Endpoint

Release Date	Feeds Affected	Benefit
08/23/2022	Competitor Merge Mappings Player Merge Mappings	Added the Competitor Merge Mappings endpoint to a variety of APIs. This feed provides the valid Sportradar Id in cases when two competitors have been merged into one. This feed was previously present in the Soccer API. Also added a Player Merge Mappings endpoint to the Aussie Rules Football API.

'Sport Events Created' Endpoint

Release Date	Feeds Affected	Benefit
06/29/2022	Sport Events Created	Our new Sport Events Created endpoint provides a list of all events created within the last 24 hours. Send requests to this endpoint as needed to assist in locating and storing newly created events.

Support for Aggregate Scores

Release Date	Feeds Affected	Benefit
05/23/2022	Competitor Summaries Daily Summaries Head to Heads Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Summaries Sport Event Summaries Sport Event Timeline Push Events Push Statistics Live Probabilities Sport Event Probabilities Timeline Probabilities	Added aggregate home and away scores for matches. Allows a display of aggregate scores for two-legged ties, reducing the need for manual calculation.

'Match Tie' Statistic

Release Date	Feeds Affected	Update
02/16/2022	Competitor Summaries Daily Summaries Head to Heads Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Summaries Sport Event Summary Sport Event Timeline Push Events Push Statistics Live Probabilities Sport Event Probabilities Timeline Probabilities	Added a `match_tie` attribute for competitions ending in a draw.

Standings Data

Release Date	Feeds Affected	Update
02/01/2022	Season Standings	Added 'Minus' points to Handball Standings, providing the points a team has lost.

Competition Gender

Release Date	Feeds Affected	Update
11/08/2021	Competition Info Competitions List Competitor Summaries Daily Summaries Head to Heads Live Summaries Player Summaries Season Info Season Summaries Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Added competition gender to several endpoints.

Pagination Update

Release Date	Feeds Affected	Update
10/15/2021	Daily Summaries Sport Events Updated	Added a pagination support description for the Daily Summaries and Sport Events Updated feeds.

Standings Types

Release Date	Feeds Affected	Benefit
10/06/2021	Season Standings	Added support for additional standings types.

Probability Match Times

Release Date	Feeds Affected	Benefit
09/22/2021	Live Probabilities Sport Event Probabilities Timeline Probabilities	Added ‘match_time’, ‘remaining_time’, and ‘remaining_time_in_period’ for relevant Probability feeds.

Season Endpoints

Release Date	Feeds Affected	Benefit
09/08/2021	Player Merge Mappings Season Competitors Season Players Seasons	Added feeds for additional support of player and seasonal data.

Referee Info

Release Date	Feeds Affected	Update
09/08/2021	Competitor Summaries Daily Summaries Head to Heads Live Summaries Player Summaries Season Probabilities Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Added referee information, including: country code, Id, name, nationality and type

Games Played Addition

Release Date	Feeds Affected	Update
09/08/2021	Season Statistics	Added `games_played` to seasonal statistics.

Standings Update

Release Date	Feeds Affected	Update
09/08/2021	Season Standings	Added “live” group indicator and “round” number to season standings.

Event Types

Release Date	Feeds Affected	Update
09/08/2021	Sport Event Timeline Push Events	Added the following player event types: blocked, foul, fouled, saved, shot

Probability Package

Release Date	Feeds Affected	Benefit
05/03/2021	Live Probabilities Season Outright Probabilities Sport Event Probabilities Sport Event Upcoming Probabilities Timeline Probabilities	Added data points to support the addition of the probabilities package feeds.

Match Stats

Release Date	Feeds Affected	Benefit
05/03/2021	Competitor Summaries Daily Summaries Head to Heads Live Summaries Player Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline	Added sport event attendance. Added “cup_round_id”, “cup_round_number_of_sport_events”, “cup_round_sport_event_number”, and “other_sport_event_id” to give more context around ties with two legs. Added “shot_type” event for score_change, shot_off_target, shot_blocked and shot_saved events. Added player “seven_m_saves” to summary and timeline endpoints.

Penalty Shootout

Release Date	Feeds Affected	Benefit
05/03/2021	Sport Event Timeline	Added FAQ information regarding shot types. Added the event type “penalty_shootout” to the list of event types.

Event Zones

Release Date	Feeds Affected	Benefit
01/11/2021	Live Timelines Live Timelines Delta Sport Event Timeline Push Events	Added the event – zone data point for available competitions.

Venue Update

Release Date	Feeds Affected	Benefit
05/20/2020	Competitor Summaries Daily Summaries Head to Head Live Summaries Player Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline	Added the following venue data points: changed, reduced_capacity, and reduced_capacity_max.

Group IDs

Release Date	Feeds Affected	Benefit
05/20/2020	Season Standings	Updated group ids in the Season Standings feed to include “sr:group:”

Neutral Ground Support

Release Date	Feeds Affected	Benefit
01/07/2020	Competitor Summaries Daily Summaries Head to Heads Live Summaries Player Summaries Live Timelines Live Timelines Delta Player Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline Push Events Push Statistics	Added the `ground` – `neutral` Boolean flag to all summary and timeline endpoints.

Shot Statistics Updates

Release Date	Feeds Affected	Benefit
01/07/2020	Competitor Summaries Daily Summaries Head to Heads Live Summaries Player Summaries Sport Event Summary Sport Event Timeline Push Statistics	Updated the shot_accuracy data point. Added the following data points to all summary and timeline endpoints: shots, shots_against, shots_off_goal, shots_on_goal.

Goalkeeper Minutes Played

Release Date	Feeds Affected	Benefit
11/21/2019	Competitor Summaries Daily Summaries Head to Heads Live Summaries Player Summaries Sport Event Summary Sport Event Timeline Push Statistics	Added the Goalkeeper Minutes Played data point to the feeds.

Push Feeds

Release Date	Feeds Affected	Benefit
09/05/2019	Push Events Push Statistics	Added Data Points in support of the Push Events and Push Statistics feeds.

Parent Competitions

Release Date	Feeds Affected	Benefit
06/03/2019	Competition List	Added Boolean flag for parent competitions: is_parent.

Competition Info Endpoint

Release Date	Feeds Affected	Benefit
04/26/2019	Competition Info	Added support for the Competition Information endpoint.

Timelines Endpoints

Release Date	Feeds Affected	Benefit
02/07/2019	Live Timelines Live Timelines Delta	Added data points in support of the new Live Timelines and Live Timelines Delta feeds.

Group & Stage Updates

Release Date	Feeds Affected	Benefit
01/10/2019	Competitor Summaries Daily Summaries Head to Heads Live Summaries Player Summaries Season Information Season Probabilities Season Standings Season Summaries Sport Event Summary Sport Event Timeline	Added group_name to the group element and added stage information to the Season Standings endpoint.

API Release

Release Date	Feeds Affected	Benefit
07/23/2018	All	Initial release of Handball v2.