Find updates to the Soccer v4 API and its documentation
Alternative Competition Names
Release Date | Feeds Affected | Benefit |
|---|---|---|
10/22/2025 | All endpoints with | We've added alternative competition names to our Soccer APIs. Use the |
{
"id": "sr:competition:17",
"name": "Premier League",
"gender": "men",
"category": {
"id": "sr:category:1",
"name": "England",
"country_code": "ENG"
},
"alternative_name": "English Premier League"
},<competition id="sr:competition:17" name="Premier League" gender="men" alternative_name="English Premier League">
<category id="sr:category:1" name="England" country_code="ENG"/>
</competition>Player Loans
Release Date | Feeds Affected | Benefit |
|---|---|---|
10/9/2025 | Competitor Profile Seasonal Competitor Players | We've updated the behavior of on-loan players in our Soccer APIs.Players on loan to other teams now appear in the Competitor Profile and Seasonal Competitor Players endpoints for their teams. They are identified using the following attributes:
|
{
"players": [
{
"id": "sr:player:143040",
"name": "Endo, Wataru",
"type": "midfielder",
"date_of_birth": "1993-02-09",
"nationality": "Japan",
"country_code": "JPN",
"height": 178,
"weight": 76,
"jersey_number": 3,
"preferred_foot": "right",
"place_of_birth": "Yokohama",
"country_of_birth": "Japan",
"gender": "male"
},
{
"id": "sr:player:151545",
"name": "Van Dijk, Virgil",
"type": "defender",
"date_of_birth": "1991-07-08",
"nationality": "Netherlands",
"country_code": "NLD",
"height": 195,
"weight": 92,
"jersey_number": 4,
"preferred_foot": "right",
"place_of_birth": "Breda",
"country_of_birth": "Netherlands",
"gender": "male"
},
{
"id": "sr:player:159665",
"name": "Salah, Mohamed",
"type": "forward",
"date_of_birth": "1992-06-15",
"nationality": "Egypt",
"country_code": "EGY",
"height": 175,
"weight": 71,
"jersey_number": 11,
"preferred_foot": "left",
"place_of_birth": "Basyoun, El Gharbia",
"country_of_birth": "Egypt",
"gender": "male"
},
{
"id": "sr:player:243609",
"name": "Alisson",
"type": "goalkeeper",
"date_of_birth": "1992-10-02",
"nationality": "Brazil",
"country_code": "BRA",
"height": 193,
"weight": 91,
"jersey_number": 1,
"preferred_foot": "right",
"place_of_birth": "Novo Hamburgo",
"country_of_birth": "Brazil",
"gender": "male"
},<player id="sr:player:143040" name="Endo, Wataru" type="midfielder" date_of_birth="1993-02-09" nationality="Japan" country_code="JPN" height="178" weight="76" jersey_number="3" preferred_foot="right" place_of_birth="Yokohama" country_of_birth="Japan" gender="male"/>
<player id="sr:player:151545" name="Van Dijk, Virgil" type="defender" date_of_birth="1991-07-08" nationality="Netherlands" country_code="NLD" height="195" weight="92" jersey_number="4" preferred_foot="right" place_of_birth="Breda" country_of_birth="Netherlands" gender="male"/>
<player id="sr:player:159665" name="Salah, Mohamed" type="forward" date_of_birth="1992-06-15" nationality="Egypt" country_code="EGY" height="175" weight="71" jersey_number="11" preferred_foot="left" place_of_birth="Basyoun, El Gharbia" country_of_birth="Egypt" gender="male"/>
<player id="sr:player:243609" name="Alisson" type="goalkeeper" date_of_birth="1992-10-02" nationality="Brazil" country_code="BRA" height="193" weight="91" jersey_number="1" preferred_foot="right" place_of_birth="Novo Hamburgo" country_of_birth="Brazil" gender="male"/>Player Birth Country - Competitor Profile Endpoint
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/7/2025 | Competitor Profile | We've added players' birth country (country_of_birth) in the Competitor Profile endpoint of our Soccer APIs. This was previously available only in the Player Profile endpoint. |
{
"players": [
{
"id": "sr:player:143040",
"name": "Endo, Wataru",
"type": "midfielder",
"date_of_birth": "1993-02-09",
"nationality": "Japan",
"country_code": "JPN",
"height": 178,
"weight": 76,
"jersey_number": 3,
"preferred_foot": "right",
"place_of_birth": "Yokohama",
"country_of_birth": "Japan",
"gender": "male"
},
{
"id": "sr:player:151545",
"name": "Van Dijk, Virgil",
"type": "defender",
"date_of_birth": "1991-07-08",
"nationality": "Netherlands",
"country_code": "NLD",
"height": 195,
"weight": 92,
"jersey_number": 4,
"preferred_foot": "right",
"place_of_birth": "Breda",
"country_of_birth": "Netherlands",
"gender": "male"
},
{
"id": "sr:player:159665",
"name": "Salah, Mohamed",
"type": "forward",
"date_of_birth": "1992-06-15",
"nationality": "Egypt",
"country_code": "EGY",
"height": 175,
"weight": 71,
"jersey_number": 11,
"preferred_foot": "left",
"place_of_birth": "Basyoun, El Gharbia",
"country_of_birth": "Egypt",
"gender": "male"
},
{
"id": "sr:player:243609",
"name": "Alisson",
"type": "goalkeeper",
"date_of_birth": "1992-10-02",
"nationality": "Brazil",
"country_code": "BRA",
"height": 193,
"weight": 91,
"jersey_number": 1,
"preferred_foot": "right",
"place_of_birth": "Novo Hamburgo",
"country_of_birth": "Brazil",
"gender": "male"
},<player id="sr:player:143040" name="Endo, Wataru" type="midfielder" date_of_birth="1993-02-09" nationality="Japan" country_code="JPN" height="178" weight="76" jersey_number="3" preferred_foot="right" place_of_birth="Yokohama" country_of_birth="Japan" gender="male"/>
<player id="sr:player:151545" name="Van Dijk, Virgil" type="defender" date_of_birth="1991-07-08" nationality="Netherlands" country_code="NLD" height="195" weight="92" jersey_number="4" preferred_foot="right" place_of_birth="Breda" country_of_birth="Netherlands" gender="male"/>
<player id="sr:player:159665" name="Salah, Mohamed" type="forward" date_of_birth="1992-06-15" nationality="Egypt" country_code="EGY" height="175" weight="71" jersey_number="11" preferred_foot="left" place_of_birth="Basyoun, El Gharbia" country_of_birth="Egypt" gender="male"/>
<player id="sr:player:243609" name="Alisson" type="goalkeeper" date_of_birth="1992-10-02" nationality="Brazil" country_code="BRA" height="193" weight="91" jersey_number="1" preferred_foot="right" place_of_birth="Novo Hamburgo" country_of_birth="Brazil" gender="male"/>Player Birth Country
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 9/10/2025 | Player Profile | We've added birth country (country_of_birth) for players in our Soccer APIs. Access a player's birth country in their Player Profile endpoint. |
"player": {
"id": "sr:player:750",
"name": "Cristiano Ronaldo",
"type": "forward",
"date_of_birth": "1985-02-05",
"nationality": "Portugal",
"country_code": "PRT",
"height": 185,
"weight": 80,
"jersey_number": 7,
"preferred_foot": "both",
"place_of_birth": "Funchal",
"country_of_birth": "Portugal",
"gender": "male"
},<player id="sr:player:750" name="Cristiano Ronaldo" type="forward" date_of_birth="1985-02-05" nationality="Portugal" country_code="PRT" height="185" weight="80" jersey_number="7" preferred_foot="both" place_of_birth="Funchal" country_of_birth="Portugal" gender="male"/>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 (
|
<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.
|
<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.
|
<?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 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 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. |
Assist Coverage Indicator
| Release Date | Feeds Affected | Benefit |
05/25/2023 | Season Info | Added an
|
Cup Round Data
| Release Date | Feeds Affected | Benefit |
03/20/2023 | Season Links | Added |
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. |
Category Data
| Release Date | Feeds Affected | Benefit |
01/20/2023 | Competition Info | Added the |
'updated' Attributes for Push Feeds
| Release Date | Feeds Affected | Benefit |
11/29/2022 | Push Events | Added |
'Lineups Confirmed' Attribute
| Release Date | Feeds Affected | Benefit |
10/11/2022 | Competitor Summaries | Added a boolean |
Venue Attribute
| Release Date | Feeds Affected | Benefit |
09/12/2022 | Competitor Summaries | Added a boolean |
Added Competition Sport Event Number
| Release Date | Feeds Affected | Benefit |
08/18/2022 | Competitor Summaries | Added a |
Order Added to Stages (Season Links)
| Release Date | Feeds Affected | Benefit |
07/12/2022 | Season Links | Added |
'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 | Added a data point ( |
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 | 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 | 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 | Added |
Season Endpoints
| Release Date | Feeds Affected | Benefit |
08/20/2021 | Season Competitors | 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. |
Probability Package
| Release Date | Feeds Affected | Benefit |
05/20/2021 | Live 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 | Added |
Aggregate Scores
| Release Date | Feeds Affected | Benefit |
05/20/2021 | Competitor Summaries | 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 | 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 | Added |
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 | 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 |
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 | 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 | 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 | Added the Lineup Availability data point for Sport Event Properties. |
Missed Penalty Shots
| Release Date | Feeds Affected | Benefit |
09/30/2019 | Competitor Summaries | 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. |
