Find updates to the Soccer v4 API and its documentation
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. |