Docs
Coverage MatrixDocumentationRelease LogLog In

Global Football Change Log

Find all updates to the Global American Football v2 API and its documentation

Round Info Additions

DateFeeds AffectedBenefit
09/26/2023Competitor 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"
},

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 Data

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.

Competition Gender Addition

Release DateFeeds AffectedBenefit
12/09/2021Competition 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.

Standings Attributes

Release DateFeeds AffectedBenefit
10/05/2021Season StandingsAdded support for additional standings types.

Match Times for Probabilities

Release DateFeeds AffectedBenefit
10/05/2021Live Probabilities
Sport Event Probabilities
Timeline Probabilities
Added ‘match_time’, ‘remaining_time’, and ‘remaining_time_in_period’ for relevant Probability feeds.

Season Endpoints

Release DateFeeds AffectedBenefit
09/13/2021Season Competitors
Season Links
Season Players
Added data points to support the addition of three seasonal feeds.

Probabilities Package

Release DateFeeds AffectedBenefit
04/12/2021Live 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.

Mapping Endpoints

Release DateFeeds AffectedBenefit
02/22/2021Competitor Mappings
Player Mappings
Player Merge Mappings
Season Mappings
Sport Event Mappings
Added data points to support the addition of the mapping feeds.

Venue Statistics

Release DateFeeds AffectedBenefit
05/11/2020Competitor Summaries
Competitor vs Competitor
Daily Summaries
Live Summaries
Player Summaries
Season Info
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 in Standings

Release DateFeeds AffectedBenefit
05/11/2020Season StandingsUpdated group ids in the Season Standings feed to include “sr:group:”

API Release

Release DateFeeds AffectedBenefit
09/24/2019Season StandingsInitial release for Global American Football v2.