Change Log

Formations Coverage Property

Release Date	Feeds Affected	Benefit
3/11/2025	All "Summaries" Endpoints All "Sport Event" Endpoints All "Schedules" Endpoints Competitor vs Competitor League Timeline Season Info Season Lineups Season Probabilities Live Probabilities Timeline Probabilities	We've added a new boolean property to our Soccer APIs to signify when a match has team formation info available. Access this data point at the season (Season Info) or sport event (Summary, Timeline, etc) level. Note that there will be some competitions in which lineups (`lineups="true`) are available but not formations (`formations="false"`). `sport_event_properties.formations` - Signifies team formations are available for a sport event when `true`

Release Date

Feeds Affected

Benefit

3/11/2025

All "Summaries" Endpoints

All "Sport Event" Endpoints

All "Schedules" Endpoints

Competitor vs Competitor

League Timeline

Season Info

Season
Lineups

Season Probabilities

Live Probabilities

Timeline Probabilities

We've added a new boolean property to our Soccer APIs to signify when a match has team formation info available. Access this data point at the season (Season Info) or sport event (Summary, Timeline, etc) level.

Note that there will be some competitions in which lineups (lineups="true) are available but not formations (formations="false").

sport_event_properties.formations - Signifies team formations are available for a sport event when true

<summary>
  <sport_event id="sr:sport_event:51092345" start_time="2024-08-09T19:00:00+00:00" start_time_confirmed="true">
    <sport_event_context>
      <sport id="sr:sport:1" name="Soccer"/>
      <category id="sr:category:1" name="England" country_code="ENG"/>
      <competition id="sr:competition:24" name="League One" gender="men"/>
      <season id="sr:season:118703" name="League One" start_date="2024-08-09" end_date="2025-05-03" year="24/25" competition_id="sr:competition:24"/>
      <stage order="1" type="league" phase="regular season" start_date="2024-08-09" end_date="2025-05-03" year="24/25"/>
      <round number="1"/>
      <groups>
        <group id="sr:league:84333" name="League One 24/25"/>
      </groups>
    </sport_event_context>
    <coverage type="sport_event">
      <sport_event_properties lineups="true" formations="false" venue="false" extended_player_stats="false" extended_team_stats="false" lineups_availability="post" ballspotting="false" commentary="false" fun_facts="true" goal_scorers="true" goal_scorers_live="false" scores="live" game_clock="true" deeper_play_by_play="false" deeper_player_stats="false" deeper_team_stats="false" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
    </coverage>

"summaries": [
  {
    "sport_event": {
      "id": "sr:sport_event:51092345",
      "start_time": "2024-08-09T19:00:00+00:00",
      "start_time_confirmed": true,
      "sport_event_context": {
        "sport": {
          "id": "sr:sport:1",
          "name": "Soccer"
        },
        "category": {
          "id": "sr:category:1",
          "name": "England",
          "country_code": "ENG"
        },
        "competition": {
          "id": "sr:competition:24",
          "name": "League One",
          "gender": "men"
        },
        "season": {
          "id": "sr:season:118703",
          "name": "League One",
          "start_date": "2024-08-09",
          "end_date": "2025-05-03",
          "year": "24/25",
          "competition_id": "sr:competition:24"
        },
        "stage": {
          "order": 1,
          "type": "league",
          "phase": "regular season",
          "start_date": "2024-08-09",
          "end_date": "2025-05-03",
          "year": "24/25"
        },
        "round": {
          "number": 1
        },
        "groups": [
          {
            "id": "sr:league:84333",
            "name": "League One 24/25"
          }
        ]
      },
      "coverage": {
        "type": "sport_event",
        "sport_event_properties": {
          "lineups": true,
          "formations": false,
          "venue": false,
          "extended_player_stats": false,
          "extended_team_stats": false,
          "lineups_availability": "post",
          "ballspotting": false,
          "commentary": false,
          "fun_facts": true,
          "goal_scorers": true,
          "goal_scorers_live": false,
          "scores": "live",
          "game_clock": true,
          "deeper_play_by_play": false,
          "deeper_player_stats": false,
          "deeper_team_stats": false,
          "basic_play_by_play": true,
          "basic_player_stats": true,
          "basic_team_stats": true
        }
      },

Live Goal Scorers Property

Release Date	Feeds Affected	Benefit
2/21/2025	All "Summaries" Endpoints All "Sport Event" Endpoints Competitor vs Competitor League Timeline Season Info Season Lineups Season Probabilities Season Schedule Live Probabilities Timeline Probabilities	We've added a new boolean property to our Soccer APIs to signify when goal scorers are available in realtime. Access this data point at the season (Season Info) or sport event (Summary, Timeline, etc) level. `sport_event_properties.goal_scorers_live` - Signifies goal scorers are available live for a sport event when `true`

Release Date

Feeds Affected

Benefit

2/21/2025

All "Summaries" Endpoints

All "Sport Event" Endpoints

Competitor vs Competitor

League Timeline

Season Info

Season
Lineups

Season Probabilities

Season Schedule

Live Probabilities

Timeline Probabilities

We've added a new boolean property to our Soccer APIs to signify when goal scorers are available in realtime. Access this data point at the season (Season Info) or sport event (Summary, Timeline, etc) level.

sport_event_properties.goal_scorers_live - Signifies goal scorers are available live for a sport event when true

<season_info
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://schemas.sportradar.com/sportsapi/soccer/v4" generated_at="2025-02-20T14:31:12+00:00" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/soccer/v4 https://d1woxfzdkvuts1.cloudfront.net/bsa-7204/soccer/v4/schemas/season_info.xsd">
	<coverage type="competition">
		<competition_properties brackets="false" missing_players="false" player_transfer_history="false" schedules="true" season_player_statistics="true" season_stats_leaders="true" season_team_statistics="true" standings="live" team_squads="true"/>
		<sport_event_properties basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true" extended_player_stats="false" extended_team_stats="false" deeper_play_by_play="false" deeper_team_stats="false" deeper_player_stats="false" lineups="true" goal_scorers="true" goal_scorers_live="true" scores="live" assists="false"/>
	</coverage>
	<season id="sr:season:118717" name="3. Liga 24/25" start_date="2024-08-02" end_date="2025-05-17" year="24/25" competition_id="sr:competition:491">
		<sport id="sr:sport:1" name="Soccer"/>
		<category id="sr:category:30" name="Germany" country_code="DEU"/>
		<competition id="sr:competition:491" name="3. Liga" gender="men"/>
	</season>
	<stages>
		<stage order="1" type="league" phase="regular season" start_date="2024-08-02" end_date="2025-05-17" year="24/25">
			<groups>
				<group id="sr:league:84997" name="3. Liga" max_rounds="38">
					<competitors>
						<competitor id="sr:competitor:2566" name="Erzgebirge Aue" country="Germany" country_code="DEU" abbreviation="ERZ" gender="male"/>
						<competitor id="sr:competitor:2595" name="Dynamo Dresden" country="Germany" country_code="DEU" abbreviation="SGD" gender="male"/>
						<competitor id="sr:competitor:2522" name="VfB Stuttgart II" country="Germany" country_code="DEU" abbreviation="VFB" gender="male" age_group="U21"/>
						<competitor id="sr:competitor:6157" name="SV Sandhausen" country="Germany" country_code="DEU" abbreviation="SVS" gender="male"/>
						<competitor id="sr:competitor:2555" name="SpVgg Unterhaching" country="Germany" country_code="DEU" abbreviation="UHA" gender="male"/>
						<competitor id="sr:competitor:2597" name="SV Wehen Wiesbaden" country="Germany" country_code="DEU" abbreviation="WEH" gender="male"/>
						<competitor id="sr:competitor:5880" name="FC Ingolstadt 04" country="Germany" country_code="DEU" abbreviation="FCI" gender="male"/>
						<competitor id="sr:competitor:2581" name="VfL 1899 Osnabruck" country="Germany" country_code="DEU" abbreviation="OSN" gender="male"/>
						<competitor id="sr:competitor:2535" name="Borussia Dortmund II" country="Germany" country_code="DEU" abbreviation="BVB" gender="male" age_group="U23"/>
						<competitor id="sr:competitor:2533" name="Hansa Rostock" country="Germany" country_code="DEU" abbreviation="HAN" gender="male"/>
						<competitor id="sr:competitor:2554" name="1. FC Saarbrucken" country="Germany" country_code="DEU" abbreviation="FCS" gender="male"/>
						<competitor id="sr:competitor:2540" name="Arminia Bielefeld" country="Germany" country_code="DEU" abbreviation="ARM" gender="male"/>
						<competitor id="sr:competitor:2546" name="Alemannia Aachen" country="Germany" country_code="DEU" abbreviation="AAC" gender="male"/>
						<competitor id="sr:competitor:2532" name="Energie Cottbus" country="Germany" country_code="DEU" abbreviation="COT" gender="male"/>
						<competitor id="sr:competitor:2680" name="SV Waldhof Mannheim 07" country="Germany" country_code="DEU" abbreviation="WAM" gender="male"/>
						<competitor id="sr:competitor:2536" name="TSV 1860 Munich" country="Germany" country_code="DEU" abbreviation="M60" gender="male"/>
						<competitor id="sr:competitor:53365" name="FC Viktoria Cologne" country="Germany" country_code="DEU" abbreviation="VIK" gender="male"/>
						<competitor id="sr:competitor:2593" name="SC Verl" country="Germany" country_code="DEU" abbreviation="SCV" gender="male"/>
						<competitor id="sr:competitor:2562" name="Rot-Weiss Essen" abbreviation="RWE" gender="male"/>
						<competitor id="sr:competitor:5801" name="Hannover 96 II" country="Germany" country_code="DEU" abbreviation="H96" gender="male" age_group="U23"/>
					</competitors>
					<coverage type="group">
						<group_properties brackets="false" cup="false" league="true" missing_players="false" qualification="false" schedules="true" results="true" standings="live" group_stage="false"/>
						<sport_event_properties basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true" lineups="true" extended_player_stats="false" extended_team_stats="false" deeper_team_stats="false" deeper_player_stats="false" deeper_play_by_play="false" goal_scorers="true" scores="live"/>
					</coverage>
				</group>
			</groups>
		</stage>
	</stages>
</season_info>

Schedule Endpoints

Release Date	Feeds Affected	Benefit
12/18/2024	Competitor Schedules Daily Schedules Live Schedules Player Schedules	We've added four Schedule endpoints to our Soccer v4 and Soccer Extended v4 APIs. Leverage these endpoints to retrieve scheduling info and high-level results by competitors, players, days, or live matches. Competitor Schedules* - Provides all upcoming scheduled matches and results for the past 30 matches for a given team. Daily Schedules** - Provides a list of scheduled matches for a given day. Live Schedules* - Provides match information for all currently live matches. Player Schedules* - Provides schedules and results of the last 10 matches played for a given player.

Release Date

Feeds Affected

Benefit

12/18/2024

Competitor Schedules

Daily Schedules

Live Schedules

Player Schedules

We've added four Schedule endpoints to our Soccer v4 and Soccer Extended v4 APIs. Leverage these endpoints to retrieve scheduling info and high-level results by competitors, players, days, or live matches.

*Competitor Schedules** - Provides all upcoming scheduled matches and results for the past 30 matches for a given team.
- Daily Schedules** - Provides a list of scheduled matches for a given day.
*Live Schedules** - Provides match information for all currently live matches.
*Player Schedules** - Provides schedules and results of the last 10 matches played for a given player.

<?xml version="1.0" encoding="UTF-8"?>
<schedule_schedules
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2024-12-18T18:43:24+00:00"
  xmlns="http://schemas.sportradar.com/sportsapi/soccer/v4" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/soccer/v4 https://schemas.sportradar.com/sportsapi/soccer/v4/schemas/schedule_schedules.xsd">
  <schedule>
    <sport_event id="sr:sport_event:46203263" start_time="2024-01-06T00:30:00+00:00" start_time_confirmed="true">
      <sport_event_context>
        <sport id="sr:sport:1" name="Soccer"/>
        <category id="sr:category:13" name="Brazil" country_code="BRA"/>
        <competition id="sr:competition:23517" name="U20 Copa Sao Paulo de Juniores" gender="men"/>
        <season id="sr:season:113951" name="U20 Copa Sao Paulo de Juniores 2024" start_date="2024-01-02" end_date="2024-01-31" year="2024" competition_id="sr:competition:23517"/>
        <stage order="1" type="league" phase="regular season" start_date="2024-01-02" end_date="2024-01-11" year="2024"/>
        <round number="2"/>
        <groups>
          <group id="sr:league:80565" name="U20 Copa Sao Paulo de Juniores 2024, Group 5" group_name="5"/>
        </groups>
      </sport_event_context>
      <coverage type="sport_event">
        <sport_event_properties lineups="false" venue="false" extended_player_stats="false" extended_team_stats="false" ballspotting="false" commentary="false" fun_facts="false" goal_scorers="false" scores="post" game_clock="false" deeper_play_by_play="false" deeper_player_stats="false" deeper_team_stats="false" basic_play_by_play="false" basic_player_stats="false" basic_team_stats="false"/>
      </coverage>
      <competitors>
        <competitor id="sr:competitor:268353" name="Rio Claro FC SP" country="Brazil" country_code="BRA" abbreviation="CLA" qualifier="home" gender="male" age_group="U20"/>
        <competitor id="sr:competitor:210350" name="Botafogo FR RJ" country="Brazil" country_code="BRA" abbreviation="BOT" qualifier="away" gender="male" age_group="U20"/>
      </competitors>
      <channels>
        <channel name="PFC HD - Hispasat 1B/1C/1D (30.0 W)" url="https://nostv.pt/guia/112" country="Portugal" country_code="PRT"/>
      </channels>
      <sport_event_conditions>
        <ground neutral="false"/>
      </sport_event_conditions>
    </sport_event>
    <sport_event_status status="closed" match_status="ended" home_score="1" away_score="2" winner_id="sr:competitor:210350">
      <period_scores>
        <period_score home_score="0" 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>
  </schedule>
  <schedule>
    <sport_event id="sr:sport_event:46513461" start_time="2024-01-06T01:06:00+00:00" start_time_confirmed="true">
      <sport_event_context>
        <sport id="sr:sport:1" name="Soccer"/>
        <category id="sr:category:12" name="Mexico" country_code="MEX"/>
        <competition id="sr:competition:28955" name="Liga MX, Women, Clausura" parent_id="sr:competition:23441" gender="women"/>
        <season id="sr:season:114105" name="Liga MX, Women, Clausura 2024" start_date="2024-01-05" end_date="2024-05-28" year="2024" competition_id="sr:competition:28955"/>
        <stage order="1" type="league" phase="regular season" start_date="2024-01-05" end_date="2024-05-05" year="2024"/>
        <round number="1"/>
        <groups>
          <group id="sr:league:80809" name="Liga MX, Women 2024, Clausura"/>
        </groups>
      </sport_event_context>
      <coverage type="sport_event">
        <sport_event_properties lineups="false" venue="false" extended_player_stats="false" extended_team_stats="false" ballspotting="false" commentary="false" fun_facts="false" goal_scorers="false" scores="post" game_clock="false" deeper_play_by_play="false" deeper_player_stats="false" deeper_team_stats="false" basic_play_by_play="false" basic_player_stats="false" basic_team_stats="false"/>
      </coverage>
      <competitors>
        <competitor id="sr:competitor:334059" name="Mazatlan FC" country="Mexico" country_code="MEX" abbreviation="MAZ" qualifier="home" gender="female"/>
        <competitor id="sr:competitor:334069" name="CF Pachuca" country="Mexico" country_code="MEX" abbreviation="PAC" qualifier="away" gender="female"/>
      </competitors>
      <sport_event_conditions>
        <ground neutral="false"/>
      </sport_event_conditions>
    </sport_event>
    <sport_event_status status="closed" match_status="ended" home_score="0" away_score="5" winner_id="sr:competitor:334069">
      <period_scores>
        <period_score home_score="0" away_score="2" type="regular_period" number="1"/>
        <period_score home_score="0" away_score="3" type="regular_period" number="2"/>
      </period_scores>
    </sport_event_status>
  </schedule>
  <schedule>
    <sport_event id="sr:sport_event:46513463" start_time="2024-01-06T03:00:00+00:00" start_time_confirmed="true">
      <sport_event_context>
        <sport id="sr:sport:1" name="Soccer"/>
        <category id="sr:category:12" name="Mexico" country_code="MEX"/>
        <competition id="sr:competition:28955" name="Liga MX, Women, Clausura" parent_id="sr:competition:23441" gender="women"/>
        <season id="sr:season:114105" name="Liga MX, Women, Clausura 2024" start_date="2024-01-05" end_date="2024-05-28" year="2024" competition_id="sr:competition:28955"/>
        <stage order="1" type="league" phase="regular season" start_date="2024-01-05" end_date="2024-05-05" year="2024"/>
        <round number="1"/>
        <groups>
          <group id="sr:league:80809" name="Liga MX, Women 2024, Clausura"/>
        </groups>
      </sport_event_context>
      <coverage type="sport_event">
        <sport_event_properties lineups="false" venue="false" extended_player_stats="false" extended_team_stats="false" ballspotting="false" commentary="false" fun_facts="false" goal_scorers="false" scores="post" game_clock="false" deeper_play_by_play="false" deeper_player_stats="false" deeper_team_stats="false" basic_play_by_play="false" basic_player_stats="false" basic_team_stats="false"/>
      </coverage>
      <competitors>
        <competitor id="sr:competitor:334061" name="CF Monterrey" country="Mexico" country_code="MEX" abbreviation="MON" qualifier="home" gender="female"/>
        <competitor id="sr:competitor:458511" name="Club Puebla" country="Mexico" country_code="MEX" abbreviation="PUE" qualifier="away" gender="female"/>
      </competitors>
      <sport_event_conditions>
        <ground neutral="false"/>
      </sport_event_conditions>
    </sport_event>
    <sport_event_status status="closed" match_status="ended" home_score="1" away_score="0" winner_id="sr:competitor:334061">
      <period_scores>
        <period_score home_score="1" away_score="0" type="regular_period" number="1"/>
        <period_score home_score="0" away_score="0" type="regular_period" number="2"/>
      </period_scores>
    </sport_event_status>
  </schedule>
</schedule_schedules>

{
  "generated_at": "2024-12-18T18:42:12+00:00",
  "schedules": [
    {
      "sport_event": {
        "id": "sr:sport_event:46203263",
        "start_time": "2024-01-06T00:30:00+00:00",
        "start_time_confirmed": true,
        "sport_event_context": {
          "sport": {
            "id": "sr:sport:1",
            "name": "Soccer"
          },
          "category": {
            "id": "sr:category:13",
            "name": "Brazil",
            "country_code": "BRA"
          },
          "competition": {
            "id": "sr:competition:23517",
            "name": "U20 Copa Sao Paulo de Juniores",
            "gender": "men"
          },
          "season": {
            "id": "sr:season:113951",
            "name": "U20 Copa Sao Paulo de Juniores 2024",
            "start_date": "2024-01-02",
            "end_date": "2024-01-31",
            "year": "2024",
            "competition_id": "sr:competition:23517"
          },
          "stage": {
            "order": 1,
            "type": "league",
            "phase": "regular season",
            "start_date": "2024-01-02",
            "end_date": "2024-01-11",
            "year": "2024"
          },
          "round": {
            "number": 2
          },
          "groups": [
            {
              "id": "sr:league:80565",
              "name": "U20 Copa Sao Paulo de Juniores 2024, Group 5",
              "group_name": "5"
            }
          ]
        },
        "coverage": {
          "type": "sport_event",
          "sport_event_properties": {
            "lineups": false,
            "venue": false,
            "extended_player_stats": false,
            "extended_team_stats": false,
            "ballspotting": false,
            "commentary": false,
            "fun_facts": false,
            "goal_scorers": false,
            "scores": "post",
            "game_clock": false,
            "deeper_play_by_play": false,
            "deeper_player_stats": false,
            "deeper_team_stats": false,
            "basic_play_by_play": false,
            "basic_player_stats": false,
            "basic_team_stats": false
          }
        },
        "competitors": [
          {
            "id": "sr:competitor:268353",
            "name": "Rio Claro FC SP",
            "country": "Brazil",
            "country_code": "BRA",
            "abbreviation": "CLA",
            "qualifier": "home",
            "gender": "male",
            "age_group": "U20"
          },
          {
            "id": "sr:competitor:210350",
            "name": "Botafogo FR RJ",
            "country": "Brazil",
            "country_code": "BRA",
            "abbreviation": "BOT",
            "qualifier": "away",
            "gender": "male",
            "age_group": "U20"
          }
        ],
        "channels": [
          {
            "name": "PFC HD - Hispasat 1B/1C/1D (30.0 W)",
            "url": "https://nostv.pt/guia/112",
            "country": "Portugal",
            "country_code": "PRT"
          }
        ],
        "sport_event_conditions": {
          "ground": {
            "neutral": false
          }
        }
      },
      "sport_event_status": {
        "status": "closed",
        "match_status": "ended",
        "home_score": 1,
        "away_score": 2,
        "winner_id": "sr:competitor:210350",
        "period_scores": [
          {
            "home_score": 0,
            "away_score": 0,
            "type": "regular_period",
            "number": 1
          },
          {
            "home_score": 1,
            "away_score": 2,
            "type": "regular_period",
            "number": 2
          }
        ]
      }
    },
    {
      "sport_event": {
        "id": "sr:sport_event:46513461",
        "start_time": "2024-01-06T01:06:00+00:00",
        "start_time_confirmed": true,
        "sport_event_context": {
          "sport": {
            "id": "sr:sport:1",
            "name": "Soccer"
          },
          "category": {
            "id": "sr:category:12",
            "name": "Mexico",
            "country_code": "MEX"
          },
          "competition": {
            "id": "sr:competition:28955",
            "name": "Liga MX, Women, Clausura",
            "parent_id": "sr:competition:23441",
            "gender": "women"
          },
          "season": {
            "id": "sr:season:114105",
            "name": "Liga MX, Women, Clausura 2024",
            "start_date": "2024-01-05",
            "end_date": "2024-05-28",
            "year": "2024",
            "competition_id": "sr:competition:28955"
          },
          "stage": {
            "order": 1,
            "type": "league",
            "phase": "regular season",
            "start_date": "2024-01-05",
            "end_date": "2024-05-05",
            "year": "2024"
          },
          "round": {
            "number": 1
          },
          "groups": [
            {
              "id": "sr:league:80809",
              "name": "Liga MX, Women 2024, Clausura"
            }
          ]
        },
        "coverage": {
          "type": "sport_event",
          "sport_event_properties": {
            "lineups": false,
            "venue": false,
            "extended_player_stats": false,
            "extended_team_stats": false,
            "ballspotting": false,
            "commentary": false,
            "fun_facts": false,
            "goal_scorers": false,
            "scores": "post",
            "game_clock": false,
            "deeper_play_by_play": false,
            "deeper_player_stats": false,
            "deeper_team_stats": false,
            "basic_play_by_play": false,
            "basic_player_stats": false,
            "basic_team_stats": false
          }
        },
        "competitors": [
          {
            "id": "sr:competitor:334059",
            "name": "Mazatlan FC",
            "country": "Mexico",
            "country_code": "MEX",
            "abbreviation": "MAZ",
            "qualifier": "home",
            "gender": "female"
          },
          {
            "id": "sr:competitor:334069",
            "name": "CF Pachuca",
            "country": "Mexico",
            "country_code": "MEX",
            "abbreviation": "PAC",
            "qualifier": "away",
            "gender": "female"
          }
        ],
        "sport_event_conditions": {
          "ground": {
            "neutral": false
          }
        }
      },
      "sport_event_status": {
        "status": "closed",
        "match_status": "ended",
        "home_score": 0,
        "away_score": 5,
        "winner_id": "sr:competitor:334069",
        "period_scores": [
          {
            "home_score": 0,
            "away_score": 2,
            "type": "regular_period",
            "number": 1
          },
          {
            "home_score": 0,
            "away_score": 3,
            "type": "regular_period",
            "number": 2
          }
        ]
      }
    },
    {
      "sport_event": {
        "id": "sr:sport_event:46513463",
        "start_time": "2024-01-06T03:00:00+00:00",
        "start_time_confirmed": true,
        "sport_event_context": {
          "sport": {
            "id": "sr:sport:1",
            "name": "Soccer"
          },
          "category": {
            "id": "sr:category:12",
            "name": "Mexico",
            "country_code": "MEX"
          },
          "competition": {
            "id": "sr:competition:28955",
            "name": "Liga MX, Women, Clausura",
            "parent_id": "sr:competition:23441",
            "gender": "women"
          },
          "season": {
            "id": "sr:season:114105",
            "name": "Liga MX, Women, Clausura 2024",
            "start_date": "2024-01-05",
            "end_date": "2024-05-28",
            "year": "2024",
            "competition_id": "sr:competition:28955"
          },
          "stage": {
            "order": 1,
            "type": "league",
            "phase": "regular season",
            "start_date": "2024-01-05",
            "end_date": "2024-05-05",
            "year": "2024"
          },
          "round": {
            "number": 1
          },
          "groups": [
            {
              "id": "sr:league:80809",
              "name": "Liga MX, Women 2024, Clausura"
            }
          ]
        },
        "coverage": {
          "type": "sport_event",
          "sport_event_properties": {
            "lineups": false,
            "venue": false,
            "extended_player_stats": false,
            "extended_team_stats": false,
            "ballspotting": false,
            "commentary": false,
            "fun_facts": false,
            "goal_scorers": false,
            "scores": "post",
            "game_clock": false,
            "deeper_play_by_play": false,
            "deeper_player_stats": false,
            "deeper_team_stats": false,
            "basic_play_by_play": false,
            "basic_player_stats": false,
            "basic_team_stats": false
          }
        },
        "competitors": [
          {
            "id": "sr:competitor:334061",
            "name": "CF Monterrey",
            "country": "Mexico",
            "country_code": "MEX",
            "abbreviation": "MON",
            "qualifier": "home",
            "gender": "female"
          },
          {
            "id": "sr:competitor:458511",
            "name": "Club Puebla",
            "country": "Mexico",
            "country_code": "MEX",
            "abbreviation": "PUE",
            "qualifier": "away",
            "gender": "female"
          }
        ],
        "sport_event_conditions": {
          "ground": {
            "neutral": false
          }
        }
      },
      "sport_event_status": {
        "status": "closed",
        "match_status": "ended",
        "home_score": 1,
        "away_score": 0,
        "winner_id": "sr:competitor:334061",
        "period_scores": [
          {
            "home_score": 1,
            "away_score": 0,
            "type": "regular_period",
            "number": 1
          },
          {
            "home_score": 0,
            "away_score": 0,
            "type": "regular_period",
            "number": 2
          }
        ]
      }
    },
  ]
}

Gender & Age Group

Release Date	Feeds Affected	Benefit
09/10/2024	Season Competitors	We added competitor `gender` and `age_group` to the Season Competitors endpoint. This info was previously available in other endpoints.

Release Date

Feeds Affected

Benefit

09/10/2024

Season Competitors

We added competitor gender and age_group to the Season Competitors endpoint.

This info was previously available in other endpoints.

<competitor id="sr:competitor:4" name="Milton Keynes Dons" short_name="Milton Keynes" abbreviation="MKD" gender="male"/>
<competitor id="sr:competitor:5" name="Bolton Wanderers" short_name="Bolton" abbreviation="BOL" gender="male"/>
<competitor id="sr:competitor:9" name="Birmingham City" short_name="Birmingham" abbreviation="BC" gender="male"/>
<competitor id="sr:competitor:10" name="Stockport County FC" short_name="Stockport" abbreviation="STO" gender="male"/>
<competitor id="sr:competitor:13" name="Rotherham United" short_name="Rotherham" abbreviation="ROU" gender="male"/>
<competitor id="sr:competitor:18" name="Grimsby Town" short_name="Grimsby" abbreviation="GRI" gender="male"/>
<competitor id="sr:competitor:19" name="Crewe Alexandra" short_name="Crewe" abbreviation="CRE" gender="male"/>
<competitor id="sr:competitor:20" name="Gillingham FC" short_name="Gillingham" abbreviation="GIL" gender="male"/>
<competitor id="sr:competitor:22" name="Bradford City" short_name="Bradford" abbreviation="BRA" gender="male"/>
<competitor id="sr:competitor:23" name="Barnsley" short_name="Barnsley" abbreviation="BAR" gender="male"/>

"season_competitors": [
  {
    "id": "sr:competitor:4",
    "name": "Milton Keynes Dons",
    "short_name": "Milton Keynes",
    "abbreviation": "MKD",
    "gender": "male"
  },
  {
    "id": "sr:competitor:5",
    "name": "Bolton Wanderers",
    "short_name": "Bolton",
    "abbreviation": "BOL",
    "gender": "male"
  },
  {
    "id": "sr:competitor:9",
    "name": "Birmingham City",
    "short_name": "Birmingham",
    "abbreviation": "BC",
    "gender": "male"
  },
  {
    "id": "sr:competitor:10",
    "name": "Stockport County FC",
    "short_name": "Stockport",
    "abbreviation": "STO",
    "gender": "male"
  },
  {
    "id": "sr:competitor:13",
    "name": "Rotherham United",
    "short_name": "Rotherham",
    "abbreviation": "ROU",
    "gender": "male"
  },
  {
    "id": "sr:competitor:18",
    "name": "Grimsby Town",
    "short_name": "Grimsby",
    "abbreviation": "GRI",
    "gender": "male"
  },
  {
    "id": "sr:competitor:19",
    "name": "Crewe Alexandra",
    "short_name": "Crewe",
    "abbreviation": "CRE",
    "gender": "male"
  },
  {
    "id": "sr:competitor:20",
    "name": "Gillingham FC",
    "short_name": "Gillingham",
    "abbreviation": "GIL",
    "gender": "male"
  },
  {
    "id": "sr:competitor:22",
    "name": "Bradford City",
    "short_name": "Bradford",
    "abbreviation": "BRA",
    "gender": "male"
  },
  {
    "id": "sr:competitor:23",
    "name": "Barnsley",
    "short_name": "Barnsley",
    "abbreviation": "BAR",
    "gender": "male"
  },

Competitor Short Name

Release Date	Feeds Affected	Benefit
07/23/2024	Competitor Profile	We added competitor `short_name` to the Competitor Profile endpoint. This was previously available in the Season Competitors and Seasonal Competitor Players endpoints.

Release Date

Feeds Affected

Benefit

07/23/2024

Competitor Profile

We added competitor short_name to the Competitor Profile endpoint.

This was previously available in the Season Competitors and Seasonal Competitor Players endpoints.

<competitor id="sr:competitor:3" name="Wolverhampton Wanderers" short_name="Wolverhampton" country="England" country_code="ENG" abbreviation="WOL" gender="male"/>
<category id="sr:category:1" name="England" country_code="ENG"/>
<sport id="sr:sport:1" name="Soccer"/>

{
    "competitor":
    {
        "id": "sr:competitor:3",
        "name": "Wolverhampton Wanderers",
        "short_name": "Wolverhampton",
        "country": "England",
        "country_code": "ENG",
        "abbreviation": "WOL",
        "gender": "male"
    },
    "category":
    {
        "id": "sr:category:1",
        "name": "England",
        "country_code": "ENG"
    },
    "sport":
    {
        "id": "sr:sport:1",
        "name": "Soccer"
    },
}

Pagination Update

Release Date	Feeds Affected	Benefit
11/27/2023	Season Schedule Season Summaries	We added and amended pagination on two endpoints to increase performance. Season Schedule: Added pagination at 1,000 events per request Season Summaries: Amended pagination from 200 to 100 events per request.

Release Date

Feeds Affected

Benefit

11/27/2023

Season Schedule

Season Summaries

We added and amended pagination on two endpoints to increase performance.

Season Schedule: Added pagination at 1,000 events per request

Season Summaries: Amended pagination from 200 to 100 events per request.

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"
        },

'Season Form Standings' Endpoint

Release Date	Feeds Affected	Benefit
06/14/2023	Season Form Standings	Released a new Season Form Standings endpoint. This endpoint provides a form table of game results and splits for a given season. It can be leveraged to easily display the W/D/L (win/draw/loss) of each team's recent matches among a variety of splits (total, home, away, 1st half total, 1st half home, 1st half away).

Assist Coverage Indicator

Release Date Feeds Affected Benefit

Release Date	Feeds Affected	Benefit
05/25/2023	Season Info	Added an `assists` Boolean value at the season level to indicate whether assists are provided for a season. `sport_event_properties assists="true"`

05/25/2023

Season Info

Added an assists Boolean value at the season level to indicate whether assists are provided for a season.

sport_event_properties assists="true"

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.

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.

'updated' Attributes for Push Feeds

Release Date	Feeds Affected	Benefit
11/29/2022	Push Events	Added `updated` and `updated_time` flags to the Push Events feed. This update will better display which game events have been updated.

'Lineups Confirmed' Attribute

Release Date	Feeds Affected	Benefit
10/11/2022	Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Added a boolean `lineups` - `confirmed` attribute to all relevant sport event endpoints. This update will signify lineups have been entered and confirmed for a match.

Venue Attribute

Release Date	Feeds Affected	Benefit
09/12/2022	Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Info Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Added a boolean `venue` attribute to all relevant summary and season endpoints. This will indicate whether venue information is available for a certain match.

Added Competition Sport Event Number

Release Date	Feeds Affected	Benefit
08/18/2022	Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Added a `competition_sport_event_number` attribute to relevant match and season endpoints. This attribute helps to support tournaments with fixed match numbers, such as the World Cup.

Order Added to Stages (Season Links)

Release Date	Feeds Affected	Benefit
07/12/2022	Season Links	Added `order` to `stages` in the Season Links endpoint. This mirrors the behavior of the Season Info endpoint, providing a structure of stages (e.g., cup -> playoffs).

'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.

Coverage Enhancement

Release Date	Feeds Affected	Benefit
06/13/2022	Match-level feeds	Added handling to support venue data population at the match level for tournaments without venue info for all matches. For example, we now support venue association for a finals match without the need for previous rounds' venues.

'Season Transfers' Endpoint

Release Date	Feeds Affected	Benefit
05/23/2022	Season Players Transfers	Added a Season Players Transfers endpoint to display changes in player roles (transfers/loans/new first-team players) in a given season.

Added 'start date' for Players

Release Date	Feeds Affected	Benefit
05/18/2022	Missing Players	Added a start date for each injury/absence in the Missing Players feed, allowing for a timeline of their absence.

Ball Situation Status

Release Date	Feeds Affected	Benefit
05/12/2022	Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timelines Push Events Push Statistics Live Probabilities Sport Event Probabilities Timeline Probabilities	Added a data point (`match_situation`) to display the ball situation during a live match (safe, dangerous, attack).

Virtual Competitor Signifier

Release Date	Feeds Affected	Benefit
01/24/2022	Season Competitors	Added a virtual competitor signifier to the Season Competitors feed.

Seasonal Statistics

Release Date	Feeds Affected	Benefit
01/04/2022	Season Over/Under Statistics	Added support for 1st half and 2nd half totals in the Season Over/Under Statistics feed.

'Season Over/Under Statistics' Endpoint

Release Date	Feeds Affected	Benefit
11/09/2021	Season Over/Under Statistics	Added data points to support the new Season Over/Under Statistics feed.

'Competitor Merge Mappings' Endpoint

Release Date	Feeds Affected	Benefit
11/02/2021	Competitor Merge Mappings	Added data points to support the new Competitor Merge Mappings feed.

Competition Gender

Release Date	Feeds Affected	Benefit
11/02/2021	Competition Info Competitions Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Info Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities	Added competition gender to several endpoints.

Category Info

Release Date	Feeds Affected	Benefit
11/02/2021	Competitions	Added category id, category name, and category country_code to the Competitions feed.

Pagination Update

Release Date	Feeds Affected	Benefit
10/15/2021	Daily Summaries Live Summaries Season Summaries Sport Events Updated	Added a pagination support description for the following feeds: Daily Summaries, Live Summaries, Season Summaries, Sport Events Updated.

Standings Types

Release Date	Feeds Affected	Benefit
10/06/2021	Season Standings	Added support for additional standings types.

Probability Match Times

Release Date	Feeds Affected	Benefit
09/22/2021	Live Probabilities Sport Event Probabilities Timeline Probabilities	Added `match_time` for relevant Probability feeds.

Season Endpoints

Release Date	Feeds Affected	Benefit
08/20/2021	Season Competitors Season Players Seasonal Competitor Players	Added data points in support of the new feeds.

Team & Player Stats

Release Date	Feeds Affected	Benefit
08/20/2021	League Timeline	Added additional statistics for teams: ball_possessions, blocked_shots, corner_kicks, fouls, fouls_suffered, offsides, saves, shots, shots_off_goal, shots_on_goal, substitutions. Added additional statistics for players: corner_kicks, fouls_suffered, offsides, own_goals, shots.

Probability Package

Release Date	Feeds Affected	Benefit
05/20/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.

'Season Links' Endpoint

Release Date	Feeds Affected	Benefit
05/20/2021	Season Links	Added data points to support the addition of the Season Links feed.

Stoppage Time

Release Date	Feeds Affected	Benefit
05/20/2021	League Timeline Live Timelines Live Timelines Delta Sport Event Timelines Push Events	Added `stoppage_time_clock` to the timeline feeds and push events.

Aggregate Scores

Release Date	Feeds Affected	Benefit
05/20/2021	Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Push Events Push Statistics	Added aggregate away and home scores, and aggregate winner info.

Standings Updates

Release Date	Feeds Affected	Benefit
10/07/2020	Season Standings	Added group comment text and competitor form to the Season Standings feed.

Match Substitution Stats

Release Date	Feeds Affected	Benefit
10/07/2020	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Summaries Sport Event Summary Sport Event Timeline Push Statistics	Added substitutions statistics to all summary and timeline feeds.

'Season Schedules' Endpoint

Release Date	Feeds Affected	Benefit
07/07/2020	Season Schedules	Added data points to support the new Season Schedules feed.

Competitor Data

Release Date	Feeds Affected	Benefit
07/07/2020	Seasonal Competitor Statistics	Added competitor data points to the Seasonal Competitor Statistics feed.

Match Tie Boolean Value

Release Date	Feeds Affected	Benefit
07/07/2020	Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Push Events Push Statistics	Added `match_tie` boolean value to `sport_event_status`.

Season Data

Release Date	Feeds Affected	Benefit
04/30/2020	Season Info	Added the following data points: competition_status and competitor other_season_id.

Venue Update

Release Date	Feeds Affected	Benefit
04/30/2020	Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Info Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Push Events Push Statistics	Added the following venue data points: changed, reduced_capacity, and reduced_capacity_max.

Leaders Endpoint Update

Release Date	Feeds Affected	Benefit
04/30/2020	Season Leaders	Added player `multiple_competitors` to the Season Leaders feed to denote when a player has played for multiple teams.

Group IDs

Release Date	Feeds Affected	Benefit
04/30/2020	Season Standings	Updated group ids in the Season Standings feed to include “sr:group:”

'League Timeline' Endpoint

Release Date	Feeds Affected	Benefit
03/17/2020	League Timeline	Added data points in support of the new League Timeline feed.

Push Feeds Release

Release Date	Feeds Affected	Benefit
03/09/2020	Push Events Push Statistics	Added data points in support of the new Push Events and Push Statistics feeds

Round Updates

Release Date	Feeds Affected	Benefit
01/08/2020	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline	Added additional round data, including: cup_round_number_of_sport_events, cup_round_sport_event_number, and other_sport_event_id. Added ground – neutral boolean flag.

Lineup Availability Support

Release Date	Feeds Affected	Benefit
09/30/2019	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Info Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline	Added the Lineup Availability data point for Sport Event Properties.

Missed Penalty Shots

Release Date	Feeds Affected	Benefit
09/30/2019	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Summaries Sport Event Summary Sport Event Timeline	Added the Penalties Missed data point.

Seasonal Competitor Stats

Release Date	Feeds Affected	Benefit
09/30/2019	Seasonal Competitor Statistics	Added the following data points: Goals Conceded First Half, Goals Conceded Second Half, Goals Scored First Half, and Goals Scored Second Half.

API Release

Release Date	Feeds Affected	Benefit
07/23/2019	All	Initial release of Soccer v4.