Soccer APIs - Start Date Confirmed Flag
May 6th, 2026
We've added a date_confirmed attribute to our Soccer APIs.
This indicates whether the scheduled date of a sport event is confirmed, even if the start time remains unconfirmed.
When date_confirmed = true and start_time_confirmed = false, the event is guaranteed to occur on the specified date, but the exact start time is still TBD.
⭐ Benefit
Definitively indicate when an upcoming match is scheduled for a specific date, when the start time on that date is not yet known.
<!-- Date confirmed, start time not yet confirmed -->
<sport_event id="sr:sport_event:68156836"
start_time="2026-05-10T00:00:00+00:00"
start_time_confirmed="false"
date_confirmed="true">☑️ Sample Request:
Season Summaries
curl --request GET \
--url https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:130281/summaries.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
Competitor:
- Schedules
- Summaries
- vs Competitor
Daily:
- Schedules
- Summaries
Season:
- Schedules
- Summaries
- Lineups
- Links
- Probabilities
Sport Event:
- Summary
- Timeline
- Lineups
- League Timeline
- Momentum (Extended)
- Extended Summary (Extended)
- Extended Timeline (Extended)
Live:
- Schedules
- Summaries
Player:
- Player Schedules
- Player Summaries
Probabilities Package:
- Live Probabilities
- Sport Event Probabilities
- Timeline Probabilities
⚙️ Return Sample
<sport_event id="sr:sport_event:68156836" start_time="2026-05-07T00:00:00+00:00" start_time_confirmed="true" date_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:36479" name="MLS Next Pro" gender="men"/>
<season id="sr:season:139090" name="MLS Next Pro 2026" start_date="2026-02-28" end_date="2026-11-09" year="2026" competition_id="sr:competition:36479"/>
<stage order="1" type="league" phase="regular season" start_date="2026-02-28" end_date="2026-09-20" year="2026"/>
<round/>
<groups>
<group id="sr:league:104598" name="MLS Next Pro 2026"/>
<group id="sr:league:104602" name="MLS Next Pro 2026, Western Conference" group_name="Western"/>
</groups>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties lineups="false" formations="false" venue="true" extended_play_by_play="false" extended_player_stats="false" extended_team_stats="false" ballspotting="false" commentary="false" fun_facts="false" goal_scorers="false" goal_scorers_live="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:239006" name="Sporting Kansas City II" country="USA" country_code="USA" abbreviation="SKC" qualifier="home" gender="male"/>
<competitor id="sr:competitor:153490" name="Ventura County FC" country="USA" country_code="USA" abbreviation="VEN" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:82567" name="Swope Park" capacity="8000" city_name="Kansas City, MO" country_name="USA" map_coordinates="39.007813, -94.5348" country_code="USA" timezone="America/Chicago"/>
<sport_event_conditions>
<ground neutral="false"/>
</sport_event_conditions>
</sport_event>{
"sport_event": {
"id": "sr:sport_event:70075098",
"start_time": "2026-05-07T00:00:00+00:00",
"start_time_confirmed": true,
"date_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:1",
"name": "Soccer"
},
"category": {
"id": "sr:category:393",
"name": "International Clubs"
},
"competition": {
"id": "sr:competition:480",
"name": "CONMEBOL Sudamericana",
"gender": "men"
},
"season": {
"id": "sr:season:138028",
"name": "CONMEBOL Sudamericana 2026",
"start_date": "2026-03-03",
"end_date": "2026-11-22",
"year": "2026",
"competition_id": "sr:competition:480"
},
"stage": {
"order": 2,
"type": "league",
"phase": "regular season",
"start_date": "2026-04-07",
"end_date": "2026-05-29",
"year": "2026"
},
"round": {
"number": 4
},
"groups": [
{
"id": "sr:league:105850",
"name": "CONMEBOL Sudamericana 2026, Group A",
"group_name": "A"
}
]
},
"coverage": {
"type": "sport_event",
"sport_event_properties": {
"lineups": true,
"formations": true,
"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:6001",
"name": "CSD Macara",
"country": "Ecuador",
"country_code": "ECU",
"abbreviation": "MAC",
"qualifier": "home",
"gender": "male"
},
{
"id": "sr:competitor:7628",
"name": "CA Tigre",
"country": "Argentina",
"country_code": "ARG",
"abbreviation": "TIG",
"qualifier": "away",
"gender": "male"
}
],
"venue": {
"id": "sr:venue:2966",
"name": "Estadio Bellavista",
"capacity": 20000,
"city_name": "Ambato",
"country_name": "Ecuador",
"map_coordinates": "-1.244694, -78.623174",
"country_code": "ECU",
"timezone": "America/Guayaquil"
},
"sport_event_conditions": {
"referees": [
{
"id": "sr:referee:1705647",
"name": "Zanovelli da Silva, Paulo Cesar",
"nationality": "Brazil",
"country_code": "BRA",
"type": "main_referee"
}
],
"ground": {
"neutral": false
}
}
},
"sport_event_status": {
"status": "not_started",
"match_status": "not_started"
}
},