Find all updates to the Global American Football v2 API and its documentation
Neutral Ground Signifier
| Release Date | Endpoints | Benefit |
|---|---|---|
| 08/19/2024 | All Summary Endpoints All Sport Event Endpoints Sport Event Timeline | We've added a neutral ground signifier to all games in the API. All sport_event, summary, and timeline endpoints will now include a sport_event_conditions element with ground neutral="true" in cases of a neutral ground matchup.This matches the current behavior of other General Sport APIs. |
<sport_event id="sr:sport_event:46791617" start_time="2024-02-11T23:30:00+00:00" start_time_confirmed="true">
<sport_event_context>
<sport id="sr:sport:16" name="American Football"/>
<category id="sr:category:43" name="USA" country_code="USA"/>
<competition id="sr:competition:31" name="NFL" gender="men"/>
<season id="sr:season:102797" name="NFL 23/24" start_date="2023-09-07" end_date="2024-02-11" year="23/24" competition_id="sr:competition:31"/>
<stage order="2" type="cup" phase="playoffs" start_date="2024-01-13" end_date="2024-02-11" year="23/24"/>
<round name="super_bowl" cup_round_sport_event_number="1" cup_round_number_of_sport_events="1" cup_round_id="sr:cup_round:2024247"/>
<groups>
<group id="sr:cup:147563" name="NFL 23/24, Playoffs"/>
</groups>
</sport_event_context>
<coverage live="true"/>
<competitors>
<competitor id="sr:competitor:4422" name="Kansas City Chiefs" country="USA" country_code="USA" abbreviation="KC" qualifier="home" gender="male" state="MO"/>
<competitor id="sr:competitor:4389" name="San Francisco 49ers" country="USA" country_code="USA" abbreviation="SF" qualifier="away" gender="male" state="CA"/>
</competitors>
<venue id="sr:venue:51543" name="Allegiant Stadium" capacity="65000" city_name="Las Vegas" country_name="USA" map_coordinates="36.090852,-115.183339" country_code="USA" timezone="America/Los_Angeles"/>
<sport_event_conditions>
<ground neutral="true"/>
</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="aet" home_score="25" away_score="22" home_normaltime_score="19" away_normaltime_score="19" winner_id="sr:competitor:4422">
<period_scores>
<period_score home_score="0" away_score="0" type="regular_period" number="1"/>
<period_score home_score="3" away_score="10" type="regular_period" number="2"/>
<period_score home_score="10" away_score="0" type="regular_period" number="3"/>
<period_score home_score="6" away_score="9" type="regular_period" number="4"/>
<period_score home_score="6" away_score="3" type="overtime"/>
</period_scores>
</sport_event_status>undefined</sport_event_summary>
{
"generated_at": "2024-08-19T13:14:27+00:00",
"sport_event": {
"id": "sr:sport_event:46791617",
"start_time": "2024-02-11T23:30:00+00:00",
"start_time_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:16",
"name": "American Football"
},
"category": {
"id": "sr:category:43",
"name": "USA",
"country_code": "USA"
},
"competition": {
"id": "sr:competition:31",
"name": "NFL",
"gender": "men"
},
"season": {
"id": "sr:season:102797",
"name": "NFL 23/24",
"start_date": "2023-09-07",
"end_date": "2024-02-11",
"year": "23/24",
"competition_id": "sr:competition:31"
},
"stage": {
"order": 2,
"type": "cup",
"phase": "playoffs",
"start_date": "2024-01-13",
"end_date": "2024-02-11",
"year": "23/24"
},
"round": {
"name": "super_bowl",
"cup_round_sport_event_number": 1,
"cup_round_number_of_sport_events": 1,
"cup_round_id": "sr:cup_round:2024247"
},
"groups": [
{
"id": "sr:cup:147563",
"name": "NFL 23/24, Playoffs"
}
]
},
"coverage": {
"live": true
},
"competitors": [
{
"id": "sr:competitor:4422",
"name": "Kansas City Chiefs",
"country": "USA",
"country_code": "USA",
"abbreviation": "KC",
"qualifier": "home",
"gender": "male",
"state": "MO"
},
{
"id": "sr:competitor:4389",
"name": "San Francisco 49ers",
"country": "USA",
"country_code": "USA",
"abbreviation": "SF",
"qualifier": "away",
"gender": "male",
"state": "CA"
}
],
"venue": {
"id": "sr:venue:51543",
"name": "Allegiant Stadium",
"capacity": 65000,
"city_name": "Las Vegas",
"country_name": "USA",
"map_coordinates": "36.090852,-115.183339",
"country_code": "USA",
"timezone": "America/Los_Angeles"
},
"sport_event_conditions": {
"ground": {
"neutral": true
}
}
},
"sport_event_status": {
"status": "closed",
"match_status": "aet",
"home_score": 25,
"away_score": 22,
"home_normaltime_score": 19,
"away_normaltime_score": 19,
"winner_id": "sr:competitor:4422",
"period_scores": [
{
"home_score": 0,
"away_score": 0,
"type": "regular_period",
"number": 1
},
{
"home_score": 3,
"away_score": 10,
"type": "regular_period",
"number": 2
},
{
"home_score": 10,
"away_score": 0,
"type": "regular_period",
"number": 3
},
{
"home_score": 6,
"away_score": 9,
"type": "regular_period",
"number": 4
},
{
"home_score": 6,
"away_score": 3,
"type": "overtime"
}
]
}
}
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"
},
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 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. |
'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. |
Competition Gender Addition
| Release Date | Feeds Affected | Benefit |
| 12/09/2021 | 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. |
Standings Attributes
| Release Date | Feeds Affected | Benefit |
| 10/05/2021 | Season Standings | Added support for additional standings types. |
Match Times for Probabilities
| Release Date | Feeds Affected | Benefit |
| 10/05/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/13/2021 | Season Competitors Season Links Season Players | Added data points to support the addition of three seasonal feeds. |
Probabilities Package
| Release Date | Feeds Affected | Benefit |
| 04/12/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. |
Mapping Endpoints
| Release Date | Feeds Affected | Benefit |
| 02/22/2021 | Competitor 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 Date | Feeds Affected | Benefit |
| 05/11/2020 | Competitor 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 Date | Feeds Affected | Benefit |
| 05/11/2020 | Season Standings | Updated group ids in the Season Standings feed to include “sr:group:” |
API Release
| Release Date | Feeds Affected | Benefit |
| 09/24/2019 | Season Standings | Initial release for Global American Football v2. |