Find updates to the Soccer v4 API and its documentation
Overtime Score Behavior Update
🗓️ Release Date 06/09/2026
We've updated the behavior of overtime scoring in our Soccer APIs.
Going forward, the home_overtime_score and away_overtime_score attributes under sport_event_status will represent the goals scored by each team during overtime (extra time) only.
Previously, these attributes reflected the final match score after overtime had concluded, rather than the goals scored during the overtime period(s).
This change is particularly relevant for competitions that can be decided after extra time, including upcoming FIFA World Cup matches.
⭐ Benefit
Use the overtime score attributes to determine how many goals each team scored during extra time without needing to calculate the values from period scores.
⚠️ Action Recommended
Review any integrations, reports, or UI displays that consume home_overtime_score and away_overtime_score.
If your implementation currently uses these fields as the final match score, update your logic to use home_score and away_score instead. Going forward, the overtime score fields will only contain goals scored during overtime periods.
☑️ Sample Request:
Sport Event Timeline
curl --request GET \
--url https://api.sportradar.com/soccer-extended/trial/v4/en/sport_events/{sport_event_id}/timeline.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
- Soccer v4 API
- Soccer Extended v4 API
🔁 Endpoints Affected
Sport Event Endpoints
- Sport Event Summary
- Sport Event Timeline
- Sport Event Extended Summary
- Sport Event Extended Timeline
- Sport Event Lineups
- League Timeline
Live Endpoints
- Live Schedules
- Live Summaries
- Live Timelines
- Live Timelines Delta
Push Feeds
- Push Events
- Push Statistics
Competitor Endpoints
- Competitor Schedules
- Competitor Summaries
- Competitor vs Competitor
Player Endpoints
- Player Schedules
- Player Summaries
Daily Endpoints
- Daily Schedules
- Daily Summaries
Season Endpoints
- Season Lineups
- Season Schedules
- Season Summaries
Probabilities
- Live Probabilities
- Season Probabilities
- Sport Event Probabilities
- Timeline Probabilities
⚙️ Return Samples
Previous Behavior Example
In the previous behavior, the overtime score attributes mirrored the final match score after overtime had concluded.
<sport_event_status status="closed" match_status="ended" home_score="3" away_score="3" home_normaltime_score="2" away_normaltime_score="2" home_overtime_score="3" away_overtime_score="3" winner_id="sr:competitor:4819">New Behavior Example
In the new behavior, the overtime score attributes reflect only the goals scored during overtime.
<sport_event_status status="closed" match_status="aet" home_score="2" away_score="1" home_normaltime_score="1" away_normaltime_score="1" home_overtime_score="1" away_overtime_score="0" winner_id="sr:competitor:2561">Late Substitution Events
🗓️ Release Date 06/02/2026
We've added a boolean late attribute to substitution events in all Soccer API Timeline endpoints. This flag indicates when a substitution was delayed because the player being replaced did not leave the field within the required time limit under the new substitution procedure introduced for the 2026 FIFA World Cup.
⭐ Benefit
Reference the event.late flag on substitution events to identify delayed substitutions. When late="true", the player being replaced did not leave the field within the required time limit, resulting in the incoming substitute being temporarily prevented from entering the field. During this delay, the team briefly plays with one fewer player until the substitution is completed.
☑️ Sample Request:
Sport Event Timeline
curl --request GET \
--url https://api.sportradar.com/soccer-extended/trial/v4/en/sport_events/{sport_event_id}/timeline.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
Soccer
- Live Timelines
- Live Timelines Delta
- Sport Event Timeline
- Push Events
Soccer Extended
- Live Timelines
- Live Timelines Delta
- Sport Event Extended Timeline
- Sport Event Timeline
- Push Events
⚙️ Return Sample
<event id="3002309890" type="substitution" time="2026-05-21T19:46:21+00:00" match_time="53" match_clock="52:30" competitor="home" period="2" period_type="regular_period" late="true">Removal of VAR Decision Field
🗓️ Release Date 06/01/2026
We've removed the decision data point from VAR review events across the Soccer and Soccer Extended APIs.
VAR review events will continue to be delivered, but the decision attribute is no longer included in the response payload.
Although the decision field has been removed, the outcome of a VAR review can still be determined using the description value on the VAR events.
The following description values may be provided:
goal/no_goalpenalty/no_penaltyred_card/no_red_cardcorner/no_cornermistaken_identity/no_mistaken_identity
☑️ Sample Request:
Sport Event Timeline (Match 70076100)
curl --request GET \
--url https://api.sportradar.com/soccer-extended/trial/v4/en/sport_events/sr:sport_event:70076100/timeline.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
The following endpoints are affected in both Soccer and Soccer Extended:
- Live Timelines
- Live Timelines Delta
- Sport Event Timeline
- Push Events
⚙️ Return Sample
A VAR review sequence continues to be represented by two timeline events:
video_assistant_referee— Indicates a VAR review has started.video_assistant_referee_over— Indicates the VAR review has concluded.
The decision field, previously available under event.decision, has been removed.
<event id="3000032774" type="video_assistant_referee" time="2026-04-29T01:07:33+00:00" match_time="50" match_clock="49:14" competitor="away" period="2" period_type="regular_period" description="penalty"/>
<event id="3000032882" type="video_assistant_referee_over" time="2026-04-29T01:09:38+00:00" match_time="52" match_clock="51:19" competitor="away" period="2" period_type="regular_period" description="penalty"/>{
"id": 3000032774,
"type": "video_assistant_referee",
"time": "2026-04-29T01:07:33+00:00",
"match_time": 50,
"match_clock": "49:14",
"competitor": "away",
"period": 2,
"period_type": "regular_period",
"description": "penalty"
},
{
"id": 3000032882,
"type": "video_assistant_referee_over",
"time": "2026-04-29T01:09:38+00:00",
"match_time": 52,
"match_clock": "51:19",
"competitor": "away",
"period": 2,
"period_type": "regular_period",
"description": "penalty"
},City IDs in Venue Objects
🗓️ Release Date 06/01/2026
We've added a city_id unique identifier to all venue objects across our General Sport Media APIs. The new field is included alongside the existing city_name field and is available in all feeds that contain venue information.
This is a non-breaking enhancement to existing responses.
"city_name": "Liverpool",
"city_id": "sr:city:31",
⭐ Benefit
Use a city's unique identifier for entity linking, data enrichment, and cross-feed correlation wherever venue information is available.
☑️ Sample Requests:
Soccer - Competitor Profile
curl --request GET \
--url https://api.sportradar.com/soccer/trial/v4/en/competitors/sr:competitor:44/profile.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'⚙️ Return Samples
<venue id="sr:venue:8117" name="Dodger Stadium" capacity="56000" city_name="Los Angeles, CA" city_id="sr:city:963" country_name="USA" map_coordinates="34.0745409, -118.2408881" country_code="USA" timezone="America/Los_Angeles"/>"venue": {
"id": "sr:venue:8117",
"name": "Dodger Stadium",
"capacity": 56000,
"city_name": "Los Angeles, CA",
"city_id": "sr:city:963",
"country_name": "USA",
"map_coordinates": "34.0745409, -118.2408881",
"country_code": "USA",
"timezone": "America/Los_Angeles"
},New VAR Event Descriptions and Player Node
🗓️ Release Date 05/26/2026
Four new description values have been added to the Soccer Timeline endpoints for Video Assistant Referee events.
Additionally, VAR timeline events will now have the ability to include an associated player name and Id.
Added description values:
cornerno_cornermistaken_identityno_mistaken_identity
⭐ Benefit
The new corner and mistaken_identity description values provide greater context into the outcome of a VAR review, enabling developers to surface more detailed decision data in their applications. The addition of the player node further enriches timeline events by associating specific players with VAR incidents.
Learn more in our VAR Review Process guide, or locate valid enums in our Soccer FAQ.
☑️ Sample Request:
Sport Event Timeline
curl --request GET \
--url https://api.sportradar.com/soccer-extended/trial/v4/en/sport_events/{sport_event_id}/timeline.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
Soccer
- Live Timelines
- Live Timelines Delta
- Sport Event Timeline
- Push Events
Soccer Extended
- Live Timelines
- Live Timelines Delta
- Sport Event Extended Timeline
- Sport Event Timeline
- Push Events
⚙️ Return Sample
<event id="4587691" type="video_assistant_referee" time="2025-08-25T20:21:57+00:00" match_time="61" match_clock="60:40" competitor="away" period="2" period_type="regular_period" description="red_card">
<players>
<player id="sr:player:560128" name="Joelinton" competitor_id="sr:competitor:39"/>
</players>
</event>
<event id="4587738" type="video_assistant_referee_over" time="2025-08-25T20:22:39+00:00" match_time="62" match_clock="61:22" competitor="away" period="2" period_type="regular_period" description="no_red_card" decision="cancelled">
<players>
<player id="sr:player:560128" name="Joelinton" competitor_id="sr:competitor:39"/>
</players>
</event><event id="4587691" type="video_assistant_referee" time="2025-08-25T20:21:57+00:00" match_time="61" match_clock="60:40" competitor="away" period="2" period_type="regular_period" description="corner"/>
<event id="4587738" type="video_assistant_referee_over" time="2025-08-25T20:22:39+00:00" match_time="62" match_clock="61:22" competitor="away" period="2" period_type="regular_period" description="no_corner" decision="cancelled"/><event id="4587691" type="video_assistant_referee" time="2025-08-25T20:21:57+00:00" match_time="61" match_clock="60:40" competitor="away" period="2" period_type="regular_period" description="mistaken_identity"/>
<event id="4587738" type="video_assistant_referee_over" time="2025-08-25T20:22:39+00:00" match_time="62" match_clock="61:22" competitor="away" period="2" period_type="regular_period" description="no_mistaken_identity" decision="cancelled"/>VAR Decisions
🗓️ Release Date 05/21/2026
We’ve added the decision data point for VAR review events across Soccer and Soccer Extended API Timeline endpoints. Previously available only in the Soccer Extended Timeline endpoint, decision now appears on video_assistant_referee_over events and indicates the outcome of the VAR review.
Possible values:pending, cancelled, upheld, overturned
⭐ Benefit
The decision data point gives you a complete picture of each VAR review — from the initial review trigger to the final outcome — so you can surface accurate, detailed VAR event data in your platform.
Learn more in our VAR Review Process guide.
☑️ Sample Request:
Sport Event Timeline (Match 70076100)
curl --request GET \
--url https://api.sportradar.com/soccer-extended/trial/v4/en/sport_events/sr:sport_event:70076100/timeline.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
Soccer
- Live Timelines
- Live Timelines Delta
- Sport Event Timeline
- Push Events
Soccer Extended
- Live Timelines
- Live Timelines Delta
- Sport Event Timeline
- Push Events
⚙️ Return Sample
A VAR sequence consists of two events: a video_assistant_referee event when the review is initiated, and a video_assistant_referee_over event when the review concludes. The decision field appears only on the closing video_assistant_referee_over event. Other timeline events may appear between the two VAR events.
<!-- VAR review initiated -->
<event id="3000032774" type="video_assistant_referee" time="2026-04-29T01:07:33+00:00" match_time="50" match_clock="49:14" competitor="away" period="2" period_type="regular_period" description="penalty"/>
<!-- Unrelated timeline event occurring during the review -->
<event id="3000032899" type="dribble" time="2026-04-29T01:10:21+00:00" match_time="52" match_clock="51:17" competitor="away" x="8" y="72" period="2" period_type="regular_period" outcome="successful">
<players>
<player id="sr:player:2150446" name="Veliz, Alejo" competitor_id="sr:competitor:3217"/>
</players>
</event>
<!-- VAR review concluded — decision returned here -->
<event id="3000032882" type="video_assistant_referee_over" time="2026-04-29T01:09:38+00:00" match_time="52" match_clock="51:19" competitor="away" period="2" period_type="regular_period" description="penalty" decision="upheld"/>// VAR review initiated
{
"id": 3000032774,
"type": "video_assistant_referee",
"time": "2026-04-29T01:07:33+00:00",
"match_time": 50,
"match_clock": "49:14",
"competitor": "away",
"period": 2,
"period_type": "regular_period",
"description": "penalty"
},
// Unrelated timeline event occurring during the review
{
"id": 3000032899,
"type": "dribble",
"time": "2026-04-29T01:10:21+00:00",
"match_time": 52,
"match_clock": "51:17",
"competitor": "away",
"x": 8,
"y": 72,
"period": 2,
"period_type": "regular_period",
"players": [
{
"id": "sr:player:2150446",
"name": "Veliz, Alejo",
"competitor_id": "sr:competitor:3217"
}
],
"outcome": "successful"
},
// VAR review concluded — decision returned here
{
"id": 3000032882,
"type": "video_assistant_referee_over",
"time": "2026-04-29T01:09:38+00:00",
"match_time": 52,
"match_clock": "51:19",
"competitor": "away",
"period": 2,
"period_type": "regular_period",
"description": "penalty",
"decision": "upheld"
}Live Third-Place Rankings for World Cup
🗓️ Release Date 05/12/2026
We’ve expanded Soccer live standings support to include ranking of the best third-placed teams across all groups.
This behavior now applies to the Standings endpoint:
- Standard group standings will continue to update dynamically during live matches.
current_outcomedata can now indicate qualification status for teams currently occupying a best third-place position.- A new live standings table will display all teams currently placed 3rd in their respective groups and rank them against one another.
This additional table is separate from the official tournament groups and is generated dynamically during live play. Teams will move into and out of the rankings as match results change.
⭐ Benefit
This update allows users to:
- Track which third-placed teams are currently advancing in the World Cup
- View the live ranking order of all third-place teams
- Monitor qualification changes in real time during simultaneous group-stage matches
The behavior mirrors existing live standings functionality, with rankings continuously recalculated throughout active matches.
☑️ Sample Request:
Season Standings (World Cup)
curl --request GET \
--url https://api.sportradar.com/soccer/trial/v4/en/seasons/sr:season:101177/standings.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
- Season Standings
⚙️ Return Sample
<season_standing tie_break_rule="In the event that two (or more) teams finish with an equal number of points, the following rules break the tie: 1. Head-to-head games between the teams concerned 1a. Points total 1b. Goal difference 1c. Goals scored 2. Overall goal difference 3. Overall number of goals scored 4. Disciplinary points 5. Higher position in FIFA World Ranking" type="best_third" points_win="3" points_draw="1" points_loss="0" round="1">
<groups>
<group id="sr:league:106218" name="Best third" live="false">
<stage order="1" type="league" phase="best third" start_date="2026-06-11" end_date="2026-06-25" year="2026"/>
<standings>
<standing rank="1" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4766" name="IR Iran" country="Iran" country_code="IRN" abbreviation="IRI" gender="male"/>
</standing>
<standing rank="2" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4718" name="Austria" country="Austria" country_code="AUT" abbreviation="AUT" gender="male"/>
</standing>
<standing rank="3" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4735" name="Korea Republic" country="Republic of Korea" country_code="KOR" abbreviation="KOR" gender="male"/>
</standing>
<standing rank="4" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4741" name="Australia" country="Australia" country_code="AUS" abbreviation="AUS" gender="male"/>
</standing>
<standing rank="5" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4768" name="Ivory Coast" country="Cote d’Ivoire" country_code="CIV" abbreviation="CIV" gender="male"/>
</standing>
<standing rank="6" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4688" name="Sweden" country="Sweden" country_code="SWE" abbreviation="SWE" gender="male"/>
</standing>
<standing rank="7" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4723" name="Uzbekistan" country="Uzbekistan" country_code="UZB" abbreviation="UZB" gender="male"/>
</standing>
<standing rank="8" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" current_outcome="Playoffs" change="0">
<competitor id="sr:competitor:4792" name="Qatar" country="Qatar" country_code="QAT" abbreviation="QAT" gender="male"/>
</standing>
<standing rank="9" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" change="0">
<competitor id="sr:competitor:4767" name="Iraq" country="Iraq" country_code="IRQ" abbreviation="IRQ" gender="male"/>
</standing>
<standing rank="10" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" change="0">
<competitor id="sr:competitor:4834" name="Saudi Arabia" country="Saudi Arabia" country_code="SAU" abbreviation="KSA" gender="male"/>
</standing>
<standing rank="11" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" change="0">
<competitor id="sr:competitor:4764" name="Ghana" country="Ghana" country_code="GHA" abbreviation="GHA" gender="male"/>
</standing>
<standing rank="12" played="0" win="0" loss="0" draw="0" goals_for="0" goals_against="0" goals_diff="0" points="0" change="0">
<competitor id="sr:competitor:7229" name="Haiti" country="Haiti" country_code="HTI" abbreviation="HTI" gender="male"/>
</standing>
</standings>
</group>
</groups>
</season_standing>{
"tie_break_rule": "In the event that two (or more) teams finish with an equal number of points, the following rules break the tie:\r\n1. Head-to-head games between the teams concerned\r\n1a. Points total\r\n1b. Goal difference\r\n1c. Goals scored\r\n2. Overall goal difference\r\n3. Overall number of goals scored\r\n4. Disciplinary points\r\n5. Higher position in FIFA World Ranking",
"type": "best_third",
"groups": [
{
"stage": {
"order": 1,
"type": "league",
"phase": "best third",
"start_date": "2026-06-11",
"end_date": "2026-06-25",
"year": "2026"
},
"id": "sr:league:106218",
"name": "Best third",
"live": false,
"standings": [
{
"rank": 1,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4766",
"name": "IR Iran",
"country": "Iran",
"country_code": "IRN",
"abbreviation": "IRI",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 2,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4718",
"name": "Austria",
"country": "Austria",
"country_code": "AUT",
"abbreviation": "AUT",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 3,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4735",
"name": "Korea Republic",
"country": "Republic of Korea",
"country_code": "KOR",
"abbreviation": "KOR",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 4,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4741",
"name": "Australia",
"country": "Australia",
"country_code": "AUS",
"abbreviation": "AUS",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 5,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4768",
"name": "Ivory Coast",
"country": "Cote d’Ivoire",
"country_code": "CIV",
"abbreviation": "CIV",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 6,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4688",
"name": "Sweden",
"country": "Sweden",
"country_code": "SWE",
"abbreviation": "SWE",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 7,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4723",
"name": "Uzbekistan",
"country": "Uzbekistan",
"country_code": "UZB",
"abbreviation": "UZB",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 8,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4792",
"name": "Qatar",
"country": "Qatar",
"country_code": "QAT",
"abbreviation": "QAT",
"gender": "male"
},
"points": 0,
"current_outcome": "Playoffs",
"change": 0
},
{
"rank": 9,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4767",
"name": "Iraq",
"country": "Iraq",
"country_code": "IRQ",
"abbreviation": "IRQ",
"gender": "male"
},
"points": 0,
"change": 0
},
{
"rank": 10,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4834",
"name": "Saudi Arabia",
"country": "Saudi Arabia",
"country_code": "SAU",
"abbreviation": "KSA",
"gender": "male"
},
"points": 0,
"change": 0
},
{
"rank": 11,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:4764",
"name": "Ghana",
"country": "Ghana",
"country_code": "GHA",
"abbreviation": "GHA",
"gender": "male"
},
"points": 0,
"change": 0
},
{
"rank": 12,
"played": 0,
"win": 0,
"loss": 0,
"draw": 0,
"goals_for": 0,
"goals_against": 0,
"goals_diff": 0,
"competitor": {
"id": "sr:competitor:7229",
"name": "Haiti",
"country": "Haiti",
"country_code": "HTI",
"abbreviation": "HTI",
"gender": "male"
},
"points": 0,
"change": 0
}
]
}
],
"points_win": 3,
"points_draw": 1,
"points_loss": 0,
"round": 1
}Start Date Confirmed Flag
🗓️ Release Date 05/06/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"
}
},Soccer Simulations
🗓️ Release Date 05/04/2026
We've added Soccer APIs to our Simulations offering!
⭐ What You Can Do
- Retrieve available recordings and supported feeds
- Replay matches on demand, on your own schedule
- Test integrations using both REST and Push feeds
New recordings will continue to be added as matches are played.
☑️ Sample Request:
Sport Event Summary
curl --location 'https://playback.sportradar.com/replay/soccer/{recording_id}?feed=summary&contentType=json&sessionId={session_id}'🔢 Versions
🔁 Endpoints Supported
Sport Event
- Lineups
- Summary
- Timeline
- Extended Summary
- Extended Timeline
Season
- Standings
- Links
- Summaries
- Leaders
- Missing Players
- Info
- Competitors
Push
- Events
- Statistics
'Seasons Disabled' Endpoint
🗓️ Release Date 04/28/2026
We've added a Seasons Disabled endpoint to each of our Soccer APIs, providing a list of currently disabled seasons, including future seasons that have not yet been enabled.
Season details and availability are subject to change prior to enablement.
⭐ Benefit
Leverage this endpoint to obtain IDs for upcoming competitions, enabling you to prepare your product for live games.
For example, pull this feed now to obtain details for this fall's Premier League:
<season id="sr:season:140756" name="Premier League 26/27" start_date="2026-08-22" end_date="2027-05-30" year="26/27" competition_id="sr:competition:17" disabled="true" />☑️ Sample Request:
Seasons Disabled
curl --request GET \
--url https://api.sportradar.com/soccer/trial/v4/en/seasons_disabled.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Versions
🔁 Endpoints Affected
⚙️ Return Sample
<season id="sr:season:140786" name="UEFA Champions League 26/27" start_date="2026-07-07" end_date="2027-06-05" year="26/27" competition_id="sr:competition:7" disabled="true"/>
<season id="sr:season:140756" name="Premier League 26/27" start_date="2026-08-22" end_date="2027-05-30" year="26/27" competition_id="sr:competition:17" disabled="true"/>
<season id="sr:season:140810" name="Championship 26/27" start_date="2026-08-14" end_date="2027-05-29" year="26/27" competition_id="sr:competition:18" disabled="true"/>
<season id="sr:season:140816" name="EFL Cup 26/27" start_date="2026-08-14" end_date="2027-02-28" year="26/27" competition_id="sr:competition:21" disabled="true"/>
<season id="sr:season:140782" name="Serie A 26/27" start_date="2026-08-21" end_date="2027-05-30" year="26/27" competition_id="sr:competition:23" disabled="true"/>"seasons_disabled": [
{
"id": "sr:season:140786",
"name": "UEFA Champions League 26/27",
"start_date": "2026-07-07",
"end_date": "2027-06-05",
"year": "26/27",
"competition_id": "sr:competition:7",
"disabled": true
},
{
"id": "sr:season:140756",
"name": "Premier League 26/27",
"start_date": "2026-08-22",
"end_date": "2027-05-30",
"year": "26/27",
"competition_id": "sr:competition:17",
"disabled": true
},
{
"id": "sr:season:140810",
"name": "Championship 26/27",
"start_date": "2026-08-14",
"end_date": "2027-05-29",
"year": "26/27",
"competition_id": "sr:competition:18",
"disabled": true
},
{
"id": "sr:season:140816",
"name": "EFL Cup 26/27",
"start_date": "2026-08-14",
"end_date": "2027-02-28",
"year": "26/27",
"competition_id": "sr:competition:21",
"disabled": true
},
{
"id": "sr:season:140782",
"name": "Serie A 26/27",
"start_date": "2026-08-21",
"end_date": "2027-05-30",
"year": "26/27",
"competition_id": "sr:competition:23",
"disabled": true
},Infrastructure Update
🗓️ Release Date 04/28/2026
We are upgrading our event infrastructure to improve consistency and quality.
No breaking changes are expected, however there is potential for some changes in behaviour. Our support team is on hand if you experience any issues.
🔢 Versions
Hydration Break Events
🗓️ Release Date 04/13/2026
We’ve added support for hydration breaks in each of our Soccer APIs.
Use these two new event types in our Soccer Timeline endpoints to determine the start and end of each hydration break.
water_break_startwater_break_end
⭐ Benefit
Integrate these event types to ensure your soccer product is compatible with the new hydration breaks for the World Cup, and other international competitions.
☑️ Sample Request:
- Sport Event Timeline -
https://api.sportradar.com/soccer/trial/v4/en/sport_events/{sport_event_id}/timeline.json
🔢 Versions
🔁 Endpoints Affected
- Live Timelines
- Live Timelines Delta
- Sport Event Timeline
- Sport Event Extended Timeline (Soccer Extended only)
- Push Events
⚙️ Return Sample
<event id="19599009" type="water_break_start" time="2026-03-12T00:52:43+00:00" match_time="23" match_clock="22:36" period="1" period_type="regular_period"/>
<event id="19599010" type="water_break_end" time="2026-03-12T00:54:48+00:00" match_time="25" match_clock="24:41" period="1" period_type="regular_period"/>Match Captains
🗓️ Release Date 03/12/2026
We’ve added support for team captains at the match level for our Soccer APIs.
Use the captain flag within the Sport Event Lineups or Season Lineups to identify which player led the team for a specific match.
Match captain is available for select upper-tier leagues. It populates when lineups.confirmed moves to true.
⭐ Benefit
Previously, our Soccer APIs only supported team-level captains via the Competitor Profile. Now, you can provide a more accurate match-day experience by identifying the specific captain for every game. This is particularly useful for matches where the permanent Club Captain is not in the starting lineup.
☑️ Sample Request:
- Sport Event Lineups -
https://api.sportradar.com/soccer/trial/v4/en/sport_events/{sport_event_id}/lineups.json - Season Lineups -
https://api.sportradar.com/soccer/trial/v4/en/seasons/{season_id}/lineups.json
🔢 Versions
🔁 Endpoints Affected
- Season Lineups
- Sport Event Lineups
⚙️ Return Sample
<player id="sr:player:100389" name="De Roon, Marten" type="midfielder" date_of_birth="1991-03-29" nationality="Netherlands" country_code="NLD" height="186" weight="76" jersey_number="15" preferred_foot="right" place_of_birth="Zwijndrecht" starter="true" captain="true" played="true" order="7" position="central_midfielder"/>{
"id": "sr:player:770677",
"name": "Zakaria, Denis",
"type": "midfielder",
"date_of_birth": "1996-11-20",
"nationality": "Switzerland",
"country_code": "CHE",
"height": 189,
"weight": 81,
"jersey_number": 6,
"preferred_foot": "right",
"place_of_birth": "Genf",
"starter": true,
"captain": true,
"played": true,
"order": 7,
"position": "central_midfielder"
}, Apertura / Clausura Season Structure Changes
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 12/22/2025 | All feeds with the season parameter | Starting with select competitions from the 2026 and 2026/27 seasons, Apertura and Clausura competitions will be represented as stages within a single season rather than separate seasons. This update improves consistency in season and competition structure. For full details, including affected competitions and integration considerations, refer to the Apertura / Clausura Season Structure FAQ. |
Team Captain
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 11/25/2025 | Competitor Profile Player Profile | We’ve added new captain indicators: use the This enhancement was made to both Soccer v4 and v4 Extended. |
<player id="sr:player:17651" name="Cazorla, Santi" type="midfielder" date_of_birth="1984-12-13" nationality="Spain" country_code="ESP" height="168" weight="65" preferred_foot="both" place_of_birth="Lugo de Llanera" country_of_birth="Spain" gender="male" captain="true"/><role type="team_captain" active="true" start_date="2025-11-18 00:00:00">
<competitor id="sr:competitor:2851" name="Real Oviedo" country="Spain" country_code="ESP" abbreviation="OVI" gender="male"/>
</role>Alternative Competition Names
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/22/2025 | All endpoints with competition info | 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 (lineups="true) are available but not formations (formations="false").
|
<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 |
| 06/14/2023 |
Assist Coverage Indicator
| Release Date |
| 05/25/2023 |
Cup Round Data
| Release Date |
| 03/20/2023 |
Pagination Update to Season Probabilities
| Release Date |
| 03/03/2023 |
Category Data
| Release Date |
| 01/20/2023 |
'updated' Attributes for Push Feeds
| Release Date |
| 11/29/2022 |
'Lineups Confirmed' Attribute
| Release Date |
| 10/11/2022 |
Venue Attribute
| Release Date |
| 09/12/2022 |
Added Competition Sport Event Number
| Release Date |
| 08/18/2022 |
Order Added to Stages (Season Links)
| Release Date |
| 07/12/2022 |
'Sport Events Created' Endpoint
| Release Date |
| 06/29/2022 |
Coverage Enhancement
| Release Date |
| 06/13/2022 |
'Season Transfers' Endpoint
| Release Date |
| 05/23/2022 |
Added 'start date' for Players
| Release Date |
| 05/18/2022 |
Ball Situation Status
| Release Date |
| 05/12/2022 |
Virtual Competitor Signifier
| Release Date |
| 01/24/2022 |
Seasonal Statistics
| Release Date |
| 01/04/2022 |
'Season Over/Under Statistics' Endpoint
| Release Date |
| 11/09/2021 |
'Competitor Merge Mappings' Endpoint
| Release Date |
| 11/02/2021 |
Competition Gender
| Release Date |
| 11/02/2021 |
Category Info
| Release Date |
| 11/02/2021 |
Pagination Update
| Release Date |
| 10/15/2021 |
Standings Types
| Release Date |
| 10/06/2021 |
Probability Match Times
| Release Date |
| 09/22/2021 |
Season Endpoints
| Release Date |
| 08/20/2021 |
Team & Player Stats
| Release Date |
| 08/20/2021 |
Probability Package
| Release Date |
| 05/20/2021 |
'Season Links' Endpoint
| Release Date |
| 05/20/2021 |
Stoppage Time
| Release Date |
| 05/20/2021 |
Aggregate Scores
| Release Date |
| 05/20/2021 |
Standings Updates
| Release Date |
| 10/07/2020 |
Match Substitution Stats
| Release Date |
| 10/07/2020 |
'Season Schedules' Endpoint
| Release Date |
| 07/07/2020 |
Competitor Data
| Release Date |
| 07/07/2020 |
Match Tie Boolean Value
| Release Date |
| 07/07/2020 |
Season Data
| Release Date |
| 04/30/2020 |
Venue Update
| Release Date |
| 04/30/2020 |
Leaders Endpoint Update
| Release Date |
| 04/30/2020 |
Group IDs
| Release Date |
| 04/30/2020 |
'League Timeline' Endpoint
| Release Date |
| 03/17/2020 |
Push Feeds Release
| Release Date |
| 03/09/2020 |
Round Updates
| Release Date |
| 01/08/2020 |
Lineup Availability Support
| Release Date |
| 09/30/2019 |
Missed Penalty Shots
| Release Date |
| 09/30/2019 |
Seasonal Competitor Stats
| Release Date |
| 09/30/2019 |
API Release
| Release Date |
| 07/23/2019 |
