Scheduling
This guide explains how to pull and display schedule information.
Prerequisite - Accessing Available Seasons
To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.
For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.
Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.
Schedule Releases
Match schedules are published between four hours to one month in advance, depending on competition priority and availability.
Lineups
Starting lineups are announced approximately 1 hour before kickoff and may be updated up to the start of the match.
We aim to deliver this data during that window, with the latest expected availability being 15 minutes into the match.
Scheduling Feeds Available
Accessing the schedule is fundamental to your integration and essential in critical scenarios. For instance, if you need to retrieve live match data, you'll first need to pull a schedule feed to obtain the event IDs for the specific matches you're targeting.
You can access Soccer scheduling data using the following feeds:
- 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. This feed updates in real time as matches are played. Matches appear a few minutes before kick-off and disappear a few minutes after the match reaches an
endedstatus. - Season Schedule - Provides basic match information for all matches for a given season, including scoring and match coverage.
Displaying Team Schedules
You can use the Competitor Schedules endpoint to display a specific team's schedule on your platform.
- Call the Seasons endpoint to retrieve the
season_idfor the tournament or season your target team is participating in. This ID is required to access the team's schedule data. - Call the Season Competitors endpoint using the
season_idto access thecompetitor_id. - Call the Competitor Schedules endpoint using the
competitor_id.
This endpoint returns the team’s upcoming matches and past 30 matches across all leagues in which they participate. - (Optional) Filter the response to include only the league(s) you’re interested in.
Competitor Schedules - Response Example
<competitor_schedules
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2025-06-30T16:32:02+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/competitor_schedules.xsd">
<schedule>
<sport_event id="sr:sport_event:57490697" start_time="2025-06-29T16:00:00+00:00" start_time_confirmed="true">
<sport_event_context>
<sport id="sr:sport:1" name="Soccer"/>
<category id="sr:category:393" name="International Clubs"/>
<competition id="sr:competition:357" name="FIFA Club World Cup" gender="men"/>
<season id="sr:season:126393" name="FIFA Club World Cup 2025" start_date="2025-06-01" end_date="2025-07-13" year="2025" competition_id="sr:competition:357"/>
<stage order="3" type="cup" phase="playoffs" start_date="2025-06-28" end_date="2025-07-13" year="2025"/>
<round name="round_of_16" cup_round_sport_event_number="1" cup_round_number_of_sport_events="1" cup_round_id="sr:cup_round:2306489"/>
<groups>
<group id="sr:cup:175667" name="FIFA Club World Cup 2025, Playoffs"/>
</groups>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties lineups="true" formations="false" venue="true" extended_play_by_play="false" extended_player_stats="false" extended_team_stats="false" lineups_availability="pre" ballspotting="true" commentary="true" fun_facts="true" goal_scorers="true" goal_scorers_live="true" scores="live" game_clock="true" deeper_play_by_play="true" deeper_player_stats="true" deeper_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
</coverage>
<competitors>
<competitor id="sr:competitor:1644" name="Paris Saint-Germain" country="France" country_code="FRA" abbreviation="PSG" qualifier="home" gender="male"/>
<competitor id="sr:competitor:659691" name="Inter Miami CF" country="USA" country_code="USA" abbreviation="MIA" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:20343" name="Mercedes-Benz Stadium" capacity="71000" city_name="Atlanta, GA" country_name="USA" map_coordinates="33.757368,-84.401008" country_code="USA" timezone="America/New_York"/>
<sport_event_conditions>
<referees>
<referee id="sr:referee:243701" name="Pereira Sampaio, Wilton" nationality="Brazil" country_code="BRA" type="main_referee"/>
</referees>
<attendance count="65574"/>
<weather pitch_conditions="good"/>
<ground neutral="true"/>
<lineups confirmed="true"/>
</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="ended" home_score="4" away_score="0" winner_id="sr:competitor:1644">
<period_scores>
<period_score home_score="4" away_score="0" type="regular_period" number="1"/>
<period_score home_score="0" away_score="0" type="regular_period" number="2"/>
</period_scores>
<ball_locations>
<ball_location order="4" x="34" y="32" qualifier="away"/>
<ball_location order="3" x="94" y="39" qualifier="away"/>
<ball_location order="2" x="94" y="39" qualifier="home"/>
<ball_location order="1" x="84" y="15" qualifier="home"/>
</ball_locations>
<match_situation status="attack" qualifier="away" updated_at="2025-06-29T17:52:45+00:00"/>
</sport_event_status>
</schedule>
<schedule>
<sport_event id="sr:sport_event:56690813" start_time="2025-06-28T23:30:00+00:00" start_time_confirmed="true" replaced_by="sr:sport_event:61472753">
<sport_event_context>
<sport id="sr:sport:1" name="Soccer"/>
<category id="sr:category:26" name="USA" country_code="USA"/>
<competition id="sr:competition:242" name="MLS" gender="men"/>
<season id="sr:season:127179" name="MLS 2025" start_date="2025-02-22" end_date="2025-12-08" year="2025" competition_id="sr:competition:242"/>
<stage order="1" type="league" phase="regular season" start_date="2025-02-22" end_date="2025-10-20" year="2025"/>
<round/>
<groups>
<group id="sr:league:89897" name="MLS 2025"/>
<group id="sr:league:89899" name="MLS 2025, Eastern Conference" group_name="Eastern Conference"/>
</groups>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties lineups="true" formations="false" venue="true" extended_play_by_play="true" extended_player_stats="true" extended_team_stats="true" lineups_availability="pre" ballspotting="true" commentary="true" fun_facts="true" goal_scorers="true" goal_scorers_live="true" scores="live" game_clock="true" deeper_play_by_play="true" deeper_player_stats="true" deeper_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
</coverage>
<competitors>
<competitor id="sr:competitor:659691" name="Inter Miami CF" country="USA" country_code="USA" abbreviation="MIA" qualifier="home" gender="male"/>
<competitor id="sr:competitor:305920" name="Atlanta United FC" country="USA" country_code="USA" abbreviation="ATL" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:51991" name="Chase Stadium" capacity="21550" city_name="Fort Lauderdale, FL" country_name="USA" map_coordinates="26.193056, -80.161111" country_code="USA" timezone="America/New_York"/>
<channels>
<channel name="Apple TV" country="United States" country_code="USA"/>
</channels>
<sport_event_conditions>
<ground neutral="false"/>
</sport_event_conditions>
</sport_event>
<sport_event_status status="postponed" match_status="postponed"/>
</schedule>
<schedule>
<sport_event id="sr:sport_event:56189293" start_time="2025-06-24T01:00:00+00:00" start_time_confirmed="true">
<sport_event_context>
<sport id="sr:sport:1" name="Soccer"/>
<category id="sr:category:393" name="International Clubs"/>
<competition id="sr:competition:357" name="FIFA Club World Cup" gender="men"/>
<season id="sr:season:126393" name="FIFA Club World Cup 2025" start_date="2025-06-01" end_date="2025-07-13" year="2025" competition_id="sr:competition:357"/>
<stage order="2" type="league" phase="regular season" start_date="2025-06-15" end_date="2025-06-27" year="2025"/>
<round number="3"/>
<groups>
<group id="sr:league:89287" name="FIFA Club World Cup 2025, Group A" group_name="A"/>
</groups>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties lineups="true" formations="false" venue="true" extended_play_by_play="false" extended_player_stats="false" extended_team_stats="false" lineups_availability="pre" ballspotting="true" commentary="true" fun_facts="true" goal_scorers="true" goal_scorers_live="true" scores="live" game_clock="true" deeper_play_by_play="true" deeper_player_stats="true" deeper_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
</coverage>
<competitors>
<competitor id="sr:competitor:659691" name="Inter Miami CF" country="USA" country_code="USA" abbreviation="MIA" qualifier="home" gender="male"/>
<competitor id="sr:competitor:1963" name="SE Palmeiras SP" country="Brazil" country_code="BRA" abbreviation="PAL" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:21306" name="Hard Rock Stadium" capacity="65326" city_name="Miami, FL" country_name="USA" map_coordinates="25.958025,-80.238724" country_code="USA" timezone="America/New_York"/>
<sport_event_conditions>
<referees>
<referee id="sr:referee:72926" name="Marciniak, Szymon" nationality="Poland" country_code="POL" type="main_referee"/>
</referees>
<attendance count="60914"/>
<weather pitch_conditions="good" overall_conditions="medium"/>
<ground neutral="true"/>
<lineups confirmed="true"/>
</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="ended" home_score="2" away_score="2" match_tie="true">
<period_scores>
<period_score home_score="1" away_score="0" type="regular_period" number="1"/>
<period_score home_score="1" away_score="2" type="regular_period" number="2"/>
</period_scores>
<ball_locations>
<ball_location order="4" x="16" y="47" qualifier="away"/>
<ball_location order="3" x="12" y="53" qualifier="away"/>
<ball_location order="2" x="44" y="52" qualifier="away"/>
<ball_location order="1" x="54" y="50" qualifier="away"/>
</ball_locations>
<match_situation status="dangerous" qualifier="away" updated_at="2025-06-24T02:54:34+00:00"/>
</sport_event_status>
</schedule>
<schedule>
<sport_event id="sr:sport_event:56189291" start_time="2025-06-19T19:00:00+00:00" start_time_confirmed="true">
<sport_event_context>
<sport id="sr:sport:1" name="Soccer"/>
<category id="sr:category:393" name="International Clubs"/>
<competition id="sr:competition:357" name="FIFA Club World Cup" gender="men"/>
<season id="sr:season:126393" name="FIFA Club World Cup 2025" start_date="2025-06-01" end_date="2025-07-13" year="2025" competition_id="sr:competition:357"/>
<stage order="2" type="league" phase="regular season" start_date="2025-06-15" end_date="2025-06-27" year="2025"/>
<round number="2"/>
<groups>
<group id="sr:league:89287" name="FIFA Club World Cup 2025, Group A" group_name="A"/>
</groups>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties lineups="true" formations="false" venue="true" extended_play_by_play="false" extended_player_stats="false" extended_team_stats="false" lineups_availability="pre" ballspotting="true" commentary="true" fun_facts="true" goal_scorers="true" goal_scorers_live="true" scores="live" game_clock="true" deeper_play_by_play="true" deeper_player_stats="true" deeper_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
</coverage>
<competitors>
<competitor id="sr:competitor:659691" name="Inter Miami CF" country="USA" country_code="USA" abbreviation="MIA" qualifier="home" gender="male"/>
<competitor id="sr:competitor:3002" name="FC Porto" country="Portugal" country_code="PRT" abbreviation="FCP" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:20343" name="Mercedes-Benz Stadium" capacity="71000" city_name="Atlanta, GA" country_name="USA" map_coordinates="33.757368,-84.401008" country_code="USA" timezone="America/New_York"/>
<sport_event_conditions>
<referees>
<referee id="sr:referee:1405029" name="Garay, Cristian" nationality="Chile" country_code="CHL" type="main_referee"/>
</referees>
<attendance count="31783"/>
<weather pitch_conditions="good" overall_conditions="medium"/>
<ground neutral="true"/>
<lineups confirmed="true"/>
</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="ended" home_score="2" away_score="1" winner_id="sr:competitor:659691">
<period_scores>
<period_score home_score="0" away_score="1" type="regular_period" number="1"/>
<period_score home_score="2" away_score="0" type="regular_period" number="2"/>
</period_scores>
<ball_locations>
<ball_location order="4" x="100" y="100" qualifier="home"/>
<ball_location order="3" x="90" y="63" qualifier="home"/>
<ball_location order="2" x="84" y="59" qualifier="home"/>
<ball_location order="1" x="89" y="63" qualifier="home"/>
</ball_locations>
<match_situation status="dangerous" qualifier="home" updated_at="2025-06-19T20:59:39+00:00"/>
</sport_event_status>
</schedule>
<schedule>
<sport_event id="sr:sport_event:56189281" start_time="2025-06-15T00:00:00+00:00" start_time_confirmed="true">
<sport_event_context>
<sport id="sr:sport:1" name="Soccer"/>
<category id="sr:category:393" name="International Clubs"/>
<competition id="sr:competition:357" name="FIFA Club World Cup" gender="men"/>
<season id="sr:season:126393" name="FIFA Club World Cup 2025" start_date="2025-06-01" end_date="2025-07-13" year="2025" competition_id="sr:competition:357"/>
<stage order="2" type="league" phase="regular season" start_date="2025-06-15" end_date="2025-06-27" year="2025"/>
<round number="1"/>
<groups>
<group id="sr:league:89287" name="FIFA Club World Cup 2025, Group A" group_name="A"/>
</groups>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties lineups="true" formations="false" venue="true" extended_play_by_play="false" extended_player_stats="false" extended_team_stats="false" lineups_availability="pre" ballspotting="true" commentary="true" fun_facts="true" goal_scorers="true" goal_scorers_live="true" scores="live" game_clock="true" deeper_play_by_play="true" deeper_player_stats="true" deeper_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
</coverage>
<competitors>
<competitor id="sr:competitor:6910" name="AL Ahly SC (EGY)" country="Egypt" country_code="EGY" abbreviation="AHL" qualifier="home" gender="male"/>
<competitor id="sr:competitor:659691" name="Inter Miami CF" country="USA" country_code="USA" abbreviation="MIA" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:21306" name="Hard Rock Stadium" capacity="65326" city_name="Miami, FL" country_name="USA" map_coordinates="25.958025,-80.238724" country_code="USA" timezone="America/New_York"/>
<channels>
<channel name="Italia 1 HD - Hot Bird 1/2/3/4/6 (13.0E)" url="http://guidatv.sky.it/guidatv/grid.html?category=sport" country="Italy" country_code="ITA"/>
<channel name="DAZN 1 France - Astra 1C-1H / 2C (19.2E)" url="https://www.footao.tv/" country="France" country_code="FRA"/>
</channels>
<sport_event_conditions>
<referees>
<referee id="sr:referee:144373" name="Faghani, Alireza" nationality="Australia" country_code="AUS" type="main_referee"/>
</referees>
<attendance count="60927"/>
<weather pitch_conditions="good" overall_conditions="medium"/>
<ground neutral="true"/>
<lineups confirmed="true"/>
</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="ended" home_score="0" away_score="0" match_tie="true">
<period_scores>
<period_score home_score="0" away_score="0" type="regular_period" number="1"/>
<period_score home_score="0" away_score="0" type="regular_period" number="2"/>
</period_scores>
<ball_locations>
<ball_location order="4" x="89" y="65" qualifier="home"/>
<ball_location order="3" x="91" y="63" qualifier="home"/>
<ball_location order="2" x="92" y="64" qualifier="home"/>
<ball_location order="1" x="91" y="69" qualifier="home"/>
</ball_locations>
<match_situation status="dangerous" qualifier="home" updated_at="2025-06-15T02:06:48+00:00"/>
</sport_event_status>
</schedule>
<schedule>
<sport_event id="sr:sport_event:56690727" start_time="2025-05-31T23:30:00+00:00" start_time_confirmed="true">
<sport_event_context>
<sport id="sr:sport:1" name="Soccer"/>
<category id="sr:category:26" name="USA" country_code="USA"/>
<competition id="sr:competition:242" name="MLS" gender="men"/>
<season id="sr:season:127179" name="MLS 2025" start_date="2025-02-22" end_date="2025-12-08" year="2025" competition_id="sr:competition:242"/>
<stage order="1" type="league" phase="regular season" start_date="2025-02-22" end_date="2025-10-20" year="2025"/>
<round/>
<groups>
<group id="sr:league:89897" name="MLS 2025"/>
<group id="sr:league:89899" name="MLS 2025, Eastern Conference" group_name="Eastern Conference"/>
</groups>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties lineups="true" formations="false" venue="true" extended_play_by_play="true" extended_player_stats="true" extended_team_stats="true" lineups_availability="pre" ballspotting="true" commentary="true" fun_facts="true" goal_scorers="true" goal_scorers_live="true" scores="live" game_clock="true" deeper_play_by_play="true" deeper_player_stats="true" deeper_team_stats="true" basic_play_by_play="true" basic_player_stats="true" basic_team_stats="true"/>
</coverage>
<competitors>
<competitor id="sr:competitor:659691" name="Inter Miami CF" country="USA" country_code="USA" abbreviation="MIA" qualifier="home" gender="male"/>
<competitor id="sr:competitor:2504" name="Columbus Crew" country="USA" country_code="USA" abbreviation="CLB" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:51991" name="Chase Stadium" capacity="21550" city_name="Fort Lauderdale, FL" country_name="USA" map_coordinates="26.193056, -80.161111" country_code="USA" timezone="America/New_York"/>
<channels>
<channel name="Apple TV" country="United States" country_code="USA"/>
</channels>
<sport_event_conditions>
<referees>
<referee id="sr:referee:1560614" name="Mendoza, Rosendo" nationality="USA" country_code="USA" type="main_referee"/>
<referee id="sr:referee:1322180" name="Greeson, Jeffrey" nationality="USA" country_code="USA" type="first_assistant_referee"/>
<referee id="sr:referee:2057859" name="Lock, Kevin" nationality="USA" country_code="USA" type="second_assistant_referee"/>
<referee id="sr:referee:1560828" name="Osmanovic, Elvis" nationality="USA" country_code="USA" type="fourth_official"/>
<referee id="sr:referee:200528" name="Jurisevic, Edvin" nationality="USA" country_code="USA" type="video_assistant_referee"/>
</referees>
<attendance count="20861"/>
<weather pitch_conditions="good" overall_conditions="medium"/>
<ground neutral="false"/>
<lineups confirmed="true"/>
</sport_event_conditions>
</sport_event>
<sport_event_status status="closed" match_status="ended" home_score="5" away_score="1" winner_id="sr:competitor:659691">
<period_scores>
<period_score home_score="3" away_score="0" type="regular_period" number="1"/>
<period_score home_score="2" away_score="1" type="regular_period" number="2"/>
</period_scores>
<ball_locations>
<ball_location order="4" x="39" y="72" qualifier="away"/>
<ball_location order="3" x="16" y="48" qualifier="away"/>
<ball_location order="2" x="16" y="44" qualifier="away"/>
<ball_location order="1" x="0" y="100" qualifier="away"/>
</ball_locations>
<match_situation status="attack" qualifier="away" updated_at="2025-06-01T01:31:51+00:00"/>
</sport_event_status>
</schedule>
</competitor_schedules>
{
"generated_at": "2025-06-30T16:28:34+00:00",
"schedules": [
{
"sport_event": {
"id": "sr:sport_event:57490697",
"start_time": "2025-06-29T16:00:00+00:00",
"start_time_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:1",
"name": "Soccer"
},
"category": {
"id": "sr:category:393",
"name": "International Clubs"
},
"competition": {
"id": "sr:competition:357",
"name": "FIFA Club World Cup",
"gender": "men"
},
"season": {
"id": "sr:season:126393",
"name": "FIFA Club World Cup 2025",
"start_date": "2025-06-01",
"end_date": "2025-07-13",
"year": "2025",
"competition_id": "sr:competition:357"
},
"stage": {
"order": 3,
"type": "cup",
"phase": "playoffs",
"start_date": "2025-06-28",
"end_date": "2025-07-13",
"year": "2025"
},
"round": {
"name": "round_of_16",
"cup_round_sport_event_number": 1,
"cup_round_number_of_sport_events": 1,
"cup_round_id": "sr:cup_round:2306489"
},
"groups": [
{
"id": "sr:cup:175667",
"name": "FIFA Club World Cup 2025, Playoffs"
}
]
},
"coverage": {
"type": "sport_event",
"sport_event_properties": {
"lineups": true,
"formations": false,
"venue": true,
"extended_play_by_play": false,
"extended_player_stats": false,
"extended_team_stats": false,
"lineups_availability": "pre",
"ballspotting": true,
"commentary": true,
"fun_facts": true,
"goal_scorers": true,
"goal_scorers_live": true,
"scores": "live",
"game_clock": true,
"deeper_play_by_play": true,
"deeper_player_stats": true,
"deeper_team_stats": true,
"basic_play_by_play": true,
"basic_player_stats": true,
"basic_team_stats": true
}
},
"competitors": [
{
"id": "sr:competitor:1644",
"name": "Paris Saint-Germain",
"country": "France",
"country_code": "FRA",
"abbreviation": "PSG",
"qualifier": "home",
"gender": "male"
},
{
"id": "sr:competitor:659691",
"name": "Inter Miami CF",
"country": "USA",
"country_code": "USA",
"abbreviation": "MIA",
"qualifier": "away",
"gender": "male"
}
],
"venue": {
"id": "sr:venue:20343",
"name": "Mercedes-Benz Stadium",
"capacity": 71000,
"city_name": "Atlanta, GA",
"country_name": "USA",
"map_coordinates": "33.757368,-84.401008",
"country_code": "USA",
"timezone": "America/New_York"
},
"sport_event_conditions": {
"referees": [
{
"id": "sr:referee:243701",
"name": "Pereira Sampaio, Wilton",
"nationality": "Brazil",
"country_code": "BRA",
"type": "main_referee"
}
],
"attendance": {
"count": 65574
},
"weather": {
"pitch_conditions": "good"
},
"ground": {
"neutral": true
},
"lineups": {
"confirmed": true
}
}
},
"sport_event_status": {
"status": "closed",
"match_status": "ended",
"home_score": 4,
"away_score": 0,
"winner_id": "sr:competitor:1644",
"period_scores": [
{
"home_score": 4,
"away_score": 0,
"type": "regular_period",
"number": 1
},
{
"home_score": 0,
"away_score": 0,
"type": "regular_period",
"number": 2
}
],
"ball_locations": [
{
"order": 4,
"x": 34,
"y": 32,
"qualifier": "away"
},
{
"order": 3,
"x": 94,
"y": 39,
"qualifier": "away"
},
{
"order": 2,
"x": 94,
"y": 39,
"qualifier": "home"
},
{
"order": 1,
"x": 84,
"y": 15,
"qualifier": "home"
}
],
"match_situation": {
"status": "attack",
"qualifier": "away",
"updated_at": "2025-06-29T17:52:45+00:00"
}
}
},
{
"sport_event": {
"id": "sr:sport_event:56690813",
"start_time": "2025-06-28T23:30:00+00:00",
"start_time_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:1",
"name": "Soccer"
},
"category": {
"id": "sr:category:26",
"name": "USA",
"country_code": "USA"
},
"competition": {
"id": "sr:competition:242",
"name": "MLS",
"gender": "men"
},
"season": {
"id": "sr:season:127179",
"name": "MLS 2025",
"start_date": "2025-02-22",
"end_date": "2025-12-08",
"year": "2025",
"competition_id": "sr:competition:242"
},
"stage": {
"order": 1,
"type": "league",
"phase": "regular season",
"start_date": "2025-02-22",
"end_date": "2025-10-20",
"year": "2025"
},
"round": {},
"groups": [
{
"id": "sr:league:89897",
"name": "MLS 2025"
},
{
"id": "sr:league:89899",
"name": "MLS 2025, Eastern Conference",
"group_name": "Eastern Conference"
}
]
},
"coverage": {
"type": "sport_event",
"sport_event_properties": {
"lineups": true,
"formations": false,
"venue": true,
"extended_play_by_play": true,
"extended_player_stats": true,
"extended_team_stats": true,
"lineups_availability": "pre",
"ballspotting": true,
"commentary": true,
"fun_facts": true,
"goal_scorers": true,
"goal_scorers_live": true,
"scores": "live",
"game_clock": true,
"deeper_play_by_play": true,
"deeper_player_stats": true,
"deeper_team_stats": true,
"basic_play_by_play": true,
"basic_player_stats": true,
"basic_team_stats": true
}
},
"competitors": [
{
"id": "sr:competitor:659691",
"name": "Inter Miami CF",
"country": "USA",
"country_code": "USA",
"abbreviation": "MIA",
"qualifier": "home",
"gender": "male"
},
{
"id": "sr:competitor:305920",
"name": "Atlanta United FC",
"country": "USA",
"country_code": "USA",
"abbreviation": "ATL",
"qualifier": "away",
"gender": "male"
}
],
"venue": {
"id": "sr:venue:51991",
"name": "Chase Stadium",
"capacity": 21550,
"city_name": "Fort Lauderdale, FL",
"country_name": "USA",
"map_coordinates": "26.193056, -80.161111",
"country_code": "USA",
"timezone": "America/New_York"
},
"channels": [
{
"name": "Apple TV",
"country": "United States",
"country_code": "USA"
}
],
"replaced_by": "sr:sport_event:61472753",
"sport_event_conditions": {
"ground": {
"neutral": false
}
}
},
"sport_event_status": {
"status": "postponed",
"match_status": "postponed"
}
},
{
"sport_event": {
"id": "sr:sport_event:56189293",
"start_time": "2025-06-24T01:00:00+00:00",
"start_time_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:1",
"name": "Soccer"
},
"category": {
"id": "sr:category:393",
"name": "International Clubs"
},
"competition": {
"id": "sr:competition:357",
"name": "FIFA Club World Cup",
"gender": "men"
},
"season": {
"id": "sr:season:126393",
"name": "FIFA Club World Cup 2025",
"start_date": "2025-06-01",
"end_date": "2025-07-13",
"year": "2025",
"competition_id": "sr:competition:357"
},
"stage": {
"order": 2,
"type": "league",
"phase": "regular season",
"start_date": "2025-06-15",
"end_date": "2025-06-27",
"year": "2025"
},
"round": {
"number": 3
},
"groups": [
{
"id": "sr:league:89287",
"name": "FIFA Club World Cup 2025, Group A",
"group_name": "A"
}
]
},
"coverage": {
"type": "sport_event",
"sport_event_properties": {
"lineups": true,
"formations": false,
"venue": true,
"extended_play_by_play": false,
"extended_player_stats": false,
"extended_team_stats": false,
"lineups_availability": "pre",
"ballspotting": true,
"commentary": true,
"fun_facts": true,
"goal_scorers": true,
"goal_scorers_live": true,
"scores": "live",
"game_clock": true,
"deeper_play_by_play": true,
"deeper_player_stats": true,
"deeper_team_stats": true,
"basic_play_by_play": true,
"basic_player_stats": true,
"basic_team_stats": true
}
},
"competitors": [
{
"id": "sr:competitor:659691",
"name": "Inter Miami CF",
"country": "USA",
"country_code": "USA",
"abbreviation": "MIA",
"qualifier": "home",
"gender": "male"
},
{
"id": "sr:competitor:1963",
"name": "SE Palmeiras SP",
"country": "Brazil",
"country_code": "BRA",
"abbreviation": "PAL",
"qualifier": "away",
"gender": "male"
}
],
"venue": {
"id": "sr:venue:21306",
"name": "Hard Rock Stadium",
"capacity": 65326,
"city_name": "Miami, FL",
"country_name": "USA",
"map_coordinates": "25.958025,-80.238724",
"country_code": "USA",
"timezone": "America/New_York"
},
"sport_event_conditions": {
"referees": [
{
"id": "sr:referee:72926",
"name": "Marciniak, Szymon",
"nationality": "Poland",
"country_code": "POL",
"type": "main_referee"
}
],
"attendance": {
"count": 60914
},
"weather": {
"pitch_conditions": "good",
"overall_conditions": "medium"
},
"ground": {
"neutral": true
},
"lineups": {
"confirmed": true
}
}
},
"sport_event_status": {
"status": "closed",
"match_status": "ended",
"home_score": 2,
"away_score": 2,
"period_scores": [
{
"home_score": 1,
"away_score": 0,
"type": "regular_period",
"number": 1
},
{
"home_score": 1,
"away_score": 2,
"type": "regular_period",
"number": 2
}
],
"match_tie": true,
"ball_locations": [
{
"order": 4,
"x": 16,
"y": 47,
"qualifier": "away"
},
{
"order": 3,
"x": 12,
"y": 53,
"qualifier": "away"
},
{
"order": 2,
"x": 44,
"y": 52,
"qualifier": "away"
},
{
"order": 1,
"x": 54,
"y": 50,
"qualifier": "away"
}
],
"match_situation": {
"status": "dangerous",
"qualifier": "away",
"updated_at": "2025-06-24T02:54:34+00:00"
}
}
},
{
"sport_event": {
"id": "sr:sport_event:56189291",
"start_time": "2025-06-19T19:00:00+00:00",
"start_time_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:1",
"name": "Soccer"
},
"category": {
"id": "sr:category:393",
"name": "International Clubs"
},
"competition": {
"id": "sr:competition:357",
"name": "FIFA Club World Cup",
"gender": "men"
},
"season": {
"id": "sr:season:126393",
"name": "FIFA Club World Cup 2025",
"start_date": "2025-06-01",
"end_date": "2025-07-13",
"year": "2025",
"competition_id": "sr:competition:357"
},
"stage": {
"order": 2,
"type": "league",
"phase": "regular season",
"start_date": "2025-06-15",
"end_date": "2025-06-27",
"year": "2025"
},
"round": {
"number": 2
},
"groups": [
{
"id": "sr:league:89287",
"name": "FIFA Club World Cup 2025, Group A",
"group_name": "A"
}
]
},
"coverage": {
"type": "sport_event",
"sport_event_properties": {
"lineups": true,
"formations": false,
"venue": true,
"extended_play_by_play": false,
"extended_player_stats": false,
"extended_team_stats": false,
"lineups_availability": "pre",
"ballspotting": true,
"commentary": true,
"fun_facts": true,
"goal_scorers": true,
"goal_scorers_live": true,
"scores": "live",
"game_clock": true,
"deeper_play_by_play": true,
"deeper_player_stats": true,
"deeper_team_stats": true,
"basic_play_by_play": true,
"basic_player_stats": true,
"basic_team_stats": true
}
},
"competitors": [
{
"id": "sr:competitor:659691",
"name": "Inter Miami CF",
"country": "USA",
"country_code": "USA",
"abbreviation": "MIA",
"qualifier": "home",
"gender": "male"
},
{
"id": "sr:competitor:3002",
"name": "FC Porto",
"country": "Portugal",
"country_code": "PRT",
"abbreviation": "FCP",
"qualifier": "away",
"gender": "male"
}
],
"venue": {
"id": "sr:venue:20343",
"name": "Mercedes-Benz Stadium",
"capacity": 71000,
"city_name": "Atlanta, GA",
"country_name": "USA",
"map_coordinates": "33.757368,-84.401008",
"country_code": "USA",
"timezone": "America/New_York"
},
"sport_event_conditions": {
"referees": [
{
"id": "sr:referee:1405029",
"name": "Garay, Cristian",
"nationality": "Chile",
"country_code": "CHL",
"type": "main_referee"
}
],
"attendance": {
"count": 31783
},
"weather": {
"pitch_conditions": "good",
"overall_conditions": "medium"
},
"ground": {
"neutral": true
},
"lineups": {
"confirmed": true
}
}
},
"sport_event_status": {
"status": "closed",
"match_status": "ended",
"home_score": 2,
"away_score": 1,
"winner_id": "sr:competitor:659691",
"period_scores": [
{
"home_score": 0,
"away_score": 1,
"type": "regular_period",
"number": 1
},
{
"home_score": 2,
"away_score": 0,
"type": "regular_period",
"number": 2
}
],
"ball_locations": [
{
"order": 4,
"x": 100,
"y": 100,
"qualifier": "home"
},
{
"order": 3,
"x": 90,
"y": 63,
"qualifier": "home"
},
{
"order": 2,
"x": 84,
"y": 59,
"qualifier": "home"
},
{
"order": 1,
"x": 89,
"y": 63,
"qualifier": "home"
}
],
"match_situation": {
"status": "dangerous",
"qualifier": "home",
"updated_at": "2025-06-19T20:59:39+00:00"
}
}
},
{
"sport_event": {
"id": "sr:sport_event:56189281",
"start_time": "2025-06-15T00:00:00+00:00",
"start_time_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:1",
"name": "Soccer"
},
"category": {
"id": "sr:category:393",
"name": "International Clubs"
},
"competition": {
"id": "sr:competition:357",
"name": "FIFA Club World Cup",
"gender": "men"
},
"season": {
"id": "sr:season:126393",
"name": "FIFA Club World Cup 2025",
"start_date": "2025-06-01",
"end_date": "2025-07-13",
"year": "2025",
"competition_id": "sr:competition:357"
},
"stage": {
"order": 2,
"type": "league",
"phase": "regular season",
"start_date": "2025-06-15",
"end_date": "2025-06-27",
"year": "2025"
},
"round": {
"number": 1
},
"groups": [
{
"id": "sr:league:89287",
"name": "FIFA Club World Cup 2025, Group A",
"group_name": "A"
}
]
},
"coverage": {
"type": "sport_event",
"sport_event_properties": {
"lineups": true,
"formations": false,
"venue": true,
"extended_play_by_play": false,
"extended_player_stats": false,
"extended_team_stats": false,
"lineups_availability": "pre",
"ballspotting": true,
"commentary": true,
"fun_facts": true,
"goal_scorers": true,
"goal_scorers_live": true,
"scores": "live",
"game_clock": true,
"deeper_play_by_play": true,
"deeper_player_stats": true,
"deeper_team_stats": true,
"basic_play_by_play": true,
"basic_player_stats": true,
"basic_team_stats": true
}
},
"competitors": [
{
"id": "sr:competitor:6910",
"name": "AL Ahly SC (EGY)",
"country": "Egypt",
"country_code": "EGY",
"abbreviation": "AHL",
"qualifier": "home",
"gender": "male"
},
{
"id": "sr:competitor:659691",
"name": "Inter Miami CF",
"country": "USA",
"country_code": "USA",
"abbreviation": "MIA",
"qualifier": "away",
"gender": "male"
}
],
"venue": {
"id": "sr:venue:21306",
"name": "Hard Rock Stadium",
"capacity": 65326,
"city_name": "Miami, FL",
"country_name": "USA",
"map_coordinates": "25.958025,-80.238724",
"country_code": "USA",
"timezone": "America/New_York"
},
"channels": [
{
"name": "Italia 1 HD - Hot Bird 1/2/3/4/6 (13.0E)",
"url": "http://guidatv.sky.it/guidatv/grid.html?category=sport",
"country": "Italy",
"country_code": "ITA"
},
{
"name": "DAZN 1 France - Astra 1C-1H / 2C (19.2E)",
"url": "https://www.footao.tv/",
"country": "France",
"country_code": "FRA"
}
],
"sport_event_conditions": {
"referees": [
{
"id": "sr:referee:144373",
"name": "Faghani, Alireza",
"nationality": "Australia",
"country_code": "AUS",
"type": "main_referee"
}
],
"attendance": {
"count": 60927
},
"weather": {
"pitch_conditions": "good",
"overall_conditions": "medium"
},
"ground": {
"neutral": true
},
"lineups": {
"confirmed": true
}
}
},
"sport_event_status": {
"status": "closed",
"match_status": "ended",
"home_score": 0,
"away_score": 0,
"period_scores": [
{
"home_score": 0,
"away_score": 0,
"type": "regular_period",
"number": 1
},
{
"home_score": 0,
"away_score": 0,
"type": "regular_period",
"number": 2
}
],
"match_tie": true,
"ball_locations": [
{
"order": 4,
"x": 89,
"y": 65,
"qualifier": "home"
},
{
"order": 3,
"x": 91,
"y": 63,
"qualifier": "home"
},
{
"order": 2,
"x": 92,
"y": 64,
"qualifier": "home"
},
{
"order": 1,
"x": 91,
"y": 69,
"qualifier": "home"
}
],
"match_situation": {
"status": "dangerous",
"qualifier": "home",
"updated_at": "2025-06-15T02:06:48+00:00"
}
}
}
]
}
You can use the data in the schedules array to power Inter Miami CF’s upcoming match schedule across multiple competitions. Filtering the entries where the competitor.id matches Inter Miami’s ID (sr:competitor:659691) and sport_event_status.status is not closed, enables you to highlight future fixtures within the team's schedule data.
The visual below demonstrates one way to render Competition Schedule data on your site. This example filters for upcoming Inter Miami CF matches in the MLS competition (sr:competition:242).
Accessing Images
To access images in the Soccer API, use the Images API.
Showcasing Recent Games
In addition to listing upcoming matches, this endpoint also provides data for recently completed games. You can use entries where status is closed to display dates and final scores.
Updated about 17 hours ago