Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Change Log

Find updates to the Soccer v4 API and its documentation

Gender & Age Group

Release DateFeeds AffectedBenefit
09/10/2024Season CompetitorsWe 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 DateFeeds AffectedBenefit
07/23/2024Competitor ProfileWe 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 DateFeeds AffectedBenefit
11/27/2023Season 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 DateFeeds AffectedBenefit
08/28/2023Sport Events CreatedAdded 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 DateFeeds AffectedBenefit
06/14/2023Season Form StandingsReleased 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 DateFeeds AffectedBenefit
05/25/2023Season InfoAdded 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 DateFeeds AffectedBenefit
03/20/2023Season LinksAdded 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 DateFeeds AffectedBenefit
03/03/2023Season ProbabilitiesAdded 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 DateFeeds AffectedBenefit
01/20/2023Competition InfoAdded 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 DateFeeds AffectedBenefit
11/29/2022Push EventsAdded 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 DateFeeds AffectedBenefit
10/11/2022Competitor 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 DateFeeds AffectedBenefit
09/12/2022Competitor 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 DateFeeds AffectedBenefit
08/18/2022Competitor 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 DateFeeds AffectedBenefit
07/12/2022Season LinksAdded 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 DateFeeds AffectedBenefit
06/29/2022Sport Events CreatedOur 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 DateFeeds AffectedBenefit
06/13/2022Match-level feedsAdded 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 DateFeeds AffectedBenefit
05/23/2022Season Players TransfersAdded 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 DateFeeds AffectedBenefit
05/18/2022Missing PlayersAdded a start date for each injury/absence in the Missing Players feed, allowing for a timeline of their absence.


Ball Situation Status

Release DateFeeds AffectedBenefit
05/12/2022Competitor 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 DateFeeds AffectedBenefit
01/24/2022Season CompetitorsAdded a virtual competitor signifier to the Season Competitors feed.


Seasonal Statistics

Release DateFeeds AffectedBenefit
01/04/2022Season Over/Under StatisticsAdded support for 1st half and 2nd half totals in the Season Over/Under Statistics feed.


'Season Over/Under Statistics' Endpoint

Release DateFeeds AffectedBenefit
11/09/2021Season Over/Under StatisticsAdded data points to support the new Season Over/Under Statistics feed.


'Competitor Merge Mappings' Endpoint

Release DateFeeds AffectedBenefit
11/02/2021Competitor Merge MappingsAdded data points to support the new Competitor Merge Mappings feed.


Competition Gender

Release DateFeeds AffectedBenefit
11/02/2021Competition 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 DateFeeds AffectedBenefit
11/02/2021CompetitionsAdded category id, category name, and category country_code to the Competitions feed.


Pagination Update

Release DateFeeds AffectedBenefit
10/15/2021Daily 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 DateFeeds AffectedBenefit
10/06/2021Season StandingsAdded support for additional standings types.


Probability Match Times

Release DateFeeds AffectedBenefit
09/22/2021Live Probabilities
Sport Event Probabilities
Timeline Probabilities
Added match_time for relevant Probability feeds.


Season Endpoints

Release DateFeeds AffectedBenefit
08/20/2021Season Competitors
Season Players
Seasonal Competitor Players
Added data points in support of the new feeds.


Team & Player Stats

Release DateFeeds AffectedBenefit
08/20/2021League TimelineAdded 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 DateFeeds AffectedBenefit
05/20/2021Live 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 DateFeeds AffectedBenefit
05/20/2021Season LinksAdded data points to support the addition of the Season Links feed.


Stoppage Time

Release DateFeeds AffectedBenefit
05/20/2021League 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 DateFeeds AffectedBenefit
05/20/2021Competitor 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 DateFeeds AffectedBenefit
10/07/2020Season StandingsAdded group comment text and competitor form to the Season Standings feed.


Match Substitution Stats

Release DateFeeds AffectedBenefit
10/07/2020Competitor 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 DateFeeds AffectedBenefit
07/07/2020Season SchedulesAdded data points to support the new Season Schedules feed.


Competitor Data

Release DateFeeds AffectedBenefit
07/07/2020Seasonal Competitor StatisticsAdded competitor data points to the Seasonal Competitor Statistics feed.


Match Tie Boolean Value

Release DateFeeds AffectedBenefit
07/07/2020Competitor 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 DateFeeds AffectedBenefit
04/30/2020Season InfoAdded the following data points: competition_status and competitor other_season_id.


Venue Update

Release DateFeeds AffectedBenefit
04/30/2020Competitor 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 DateFeeds AffectedBenefit
04/30/2020Season LeadersAdded player multiple_competitors to the Season Leaders feed to denote when a player has played for multiple teams.


Group IDs

Release DateFeeds AffectedBenefit
04/30/2020Season StandingsUpdated group ids in the Season Standings feed to include “sr:group:”


'League Timeline' Endpoint

Release DateFeeds AffectedBenefit
03/17/2020League TimelineAdded data points in support of the new League Timeline feed.


Push Feeds Release

Release DateFeeds AffectedBenefit
03/09/2020Push Events
Push Statistics
Added data points in support of the new Push Events and Push Statistics feeds


Round Updates

Release DateFeeds AffectedBenefit
01/08/2020Competitor 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 DateFeeds AffectedBenefit
09/30/2019Competitor 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 DateFeeds AffectedBenefit
09/30/2019Competitor 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 DateFeeds AffectedBenefit
09/30/2019Seasonal Competitor StatisticsAdded the following data points: Goals Conceded First Half, Goals Conceded Second Half, Goals Scored First Half, and Goals Scored Second Half.


API Release

Release DateFeeds AffectedBenefit
07/23/2019AllInitial release of Soccer v4.