Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Find all updates to the Futsal v2 API and its documentation

Support for Aggregate Scores

Release DateFeeds AffectedBenefit
05/03/2024Competitor 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

DateFeeds AffectedBenefit
09/26/2023Competitor 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 DateFeeds AffectedBenefit
08/28/2023Sport Events CreatedAdded 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 DateFeeds AffectedBenefit
03/20/2023Season LinksAdded 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 DateFeeds AffectedBenefit
03/13/2023Competitor 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 DateFeeds AffectedBenefit
03/03/2023Season ProbabilitiesAdded 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 DateFeeds AffectedBenefit
01/20/2023Competition InfoAdded 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 DateFeeds AffectedBenefit
08/23/2022Competitor 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 DateFeeds AffectedBenefit
06/29/2022Sport Events CreatedOur 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 DateFeeds AffectedBenefit
04/20/2022Competitor 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 DateFeeds AffectedBenefit
02/06/2022Competition 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 DateFeeds AffectedBenefit
10/05/2021AllInitial release of Futsal v2.