Find all updates to the Handball v2 API and its documentation
Manager Info in Lineups
Release Date | Feeds Affected | Benefit |
|---|---|---|
05/29/2024 | Season Lineups Sport Event Lineups | We have added manager information to the Sport Event and Season Lineups feeds. This info was previously only available in the Competitor Profile feed. Manager data points include: country code, Id, name, and nationality. Manager info is currently only available for German Bundesliga Men's and Women's competitions. |
<manager id="sr:player:1638458" name="Krickau, Nicolej" nationality="Denmark" country_code="DNK"/>"manager":
{
"id": "sr:player:1638458",
"name": "Krickau, Nicolej",
"nationality": "Denmark",
"country_code": "DNK"
}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. Inserted a
|
<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 | Added goalkeeper details on |
<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 | Added data points related to tournament New data points include:
|
<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 | Added two new event types: 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 |
<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. |
