Find updates to the Soccer v4 API and its documentation
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. |
<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. |
<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. |
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 |
05/25/2023 | Season Info | Added an assists Boolean value at the season level to indicate whether assists are provided for a season.
|
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. |