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.