Find all updates to the Futsal v2 API and its documentation
Support for Aggregate Scores
Release Date | Feeds Affected | Benefit |
---|---|---|
05/03/2024 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Live Timelines Live Timelines Delta Season Summaries Sport Event Summary Sport Event Timeline | Added aggregate home and away scores for matches, including a winner_id for the winning team.This update allows a display of aggregate scores for two-legged ties, reducing the need for manual calculation. |
<sport_event_status status="closed" match_status="ended" home_score="2" away_score="2" aggregate_home_score="5" aggregate_away_score="4" aggregate_winner_id="sr:competitor:34498">
<period_scores>
<period_score home_score="1" away_score="0" type="regular_period" number="1"/>
<period_score home_score="1" away_score="2" type="regular_period" number="2"/>
</period_scores>
</sport_event_status>
"sport_event_status": {
"status": "closed",
"match_status": "ended",
"home_score": 2,
"away_score": 2,
"period_scores": [
{
"home_score": 1,
"away_score": 0,
"type": "regular_period",
"number": 1
},
{
"home_score": 1,
"away_score": 2,
"type": "regular_period",
"number": 2
}
],
"aggregate_home_score": 5,
"aggregate_away_score": 4,
"aggregate_winner_id": "sr:competitor:34498"
},
Round Info Additions
Date | Feeds Affected | Benefit |
---|---|---|
09/26/2023 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline | 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"
},
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"
},
Cup Round Info
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. |
'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 Draws
Release Date | Feeds Affected | Benefit |
04/20/2022 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Live Timelines Live Timelines Delta Season Summaries Sport Event Summary Sport Event Timeline | Added a match_tie attribute for competitions ending in a draw. |
Gender Distinction
Release Date | Feeds Affected | Benefit |
02/06/2022 | Competition Info Competitions Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Info Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities | Added competition gender to several endpoints. |
API Release
Release Date | Feeds Affected | Benefit |
10/05/2021 | All | Initial release of Futsal v2. |