Soccer APIs - New Schedule Endpoints
December 18th, 2024
We've added four Schedule endpoints to our Soccer v4 and Soccer Extended v4 APIs. Leverage these endpoints to retrieve scheduling info and high-level results by competitors, players, days, or live matches.
Competitor Schedules - Provides all upcoming scheduled matches and results for the past 30 matches for a given team.
Daily Schedules - Provides a list of scheduled matches for a given day.
Live Schedules - Provides match information for all currently live matches.
Player Schedules - Provides schedules and results of the last 10 matches played for a given player.
☑️ Sample Requests:
Competitor Schedules - https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/schedules.json?api_key=[API_KEY]
Daily Schedules - https://api.sportradar.com/soccer/trial/v4/en/schedules/2024-01-06/schedules.json?api_key=[API_KEY]
Live Schedules - https://api.sportradar.com/soccer/trial/v4/en/schedules/live/schedules.json?api_key=[API_KEY]
Player Schedules - https://api.sportradar.com/soccer/trial/v4/en/players/sr:player:159665/schedules.json?api_key=[API_KEY]
🔢 Versions
🔁 Endpoints Affected
Soccer v4: Competitor Schedules, Daily Schedules, Live Schedules, Player Schedules
Soccer Extended v4: Competitor Schedules, Daily Schedules, Live Schedules, Player Schedules
⚙️ Return Samples
<?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
}
]
}
},
]
}