Find updates to the Soccer v4 API and its documentation
FA Cup Competition Consolidation
🗓️ Release Date 08/05/2026
We're consolidating the qualification and main-draw rounds of the FA Cup and FA Trophy into single competitions in our Soccer and Soccer Extended APIs.
Currently, the qualification rounds and main competition for these two events are maintained as separate competitions. Beginning with the new season, the standalone qualification competitions will be retired, and all qualification and main-draw content will be delivered through a single competition for each event:
| Retired Competition | Content now delivered through |
|---|---|
1696 – FA Cup, Qualification | 19 – FA Cup |
1991 – FA Trophy, Qualification | 628 – FA Trophy |
You can confirm these competition IDs through the Competitions endpoint (shown below). Competitions 1696 and 1991 will be retired, with all qualification content delivered through 19 and 628 respectively.
This change applies only to the FA Cup and FA Trophy. Other qualification tournaments that exist as independent competitions — such as the FIFA World Cup qualifiers and UEFA European Championship qualifiers — are structured differently and are not affected.
⭐ Benefit
Access both qualification and main-draw content for the FA Cup and FA Trophy through a single competition ID each, rather than tracking separate competitions for qualification and main rounds.
📋 Recommended Actions
- Update any integration that references competitions
1696(FA Cup, Qualification) or1991(FA Trophy, Qualification), as these will be retired. - Retrieve qualification and main-draw content for the FA Cup and FA Trophy from competitions
19and628respectively. - Confirm this change is in place before the new season begins on 23 August.
🔢 Products
| Sport | Product | Version(s) |
|---|---|---|
| Soccer | Soccer API | v4 |
| Soccer | Soccer Extended API | v4 |
🔁 Competitions Affected
19– FA Cup628– FA Trophy1696– FA Cup, Qualification (retired)1991– FA Trophy, Qualification (retired)
☑️ Sample Request:
Retrieve these competitions through the Competitions endpoint:
curl --request GET \
--url https://api.sportradar.com/soccer/trial/v4/en/competitions.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'⚙️ Return Samples
The following shows the four competitions as they currently exist. After the change, 1696 and 1991 will no longer be returned.
<competition id="sr:competition:19" name="FA Cup" gender="men">
<category id="sr:category:1" name="England" country_code="ENG"/>
</competition>
<competition id="sr:competition:628" name="FA Trophy" gender="men">
<category id="sr:category:252" name="England Amateur" country_code="ENG"/>
</competition>
<competition id="sr:competition:1696" name="FA Cup, Qualification" gender="men">
<category id="sr:category:1" name="England" country_code="ENG"/>
</competition>
<competition id="sr:competition:1991" name="FA Trophy, Qualification" gender="men">
<category id="sr:category:252" name="England Amateur" country_code="ENG"/>
</competition>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 | Feeds Affected | Benefit |
| 06/14/2023 | Season Form Standings | Released a new Season Form Standings endpoint. This endpoint provides a form table of game results and splits for a given season. It can be leveraged to easily display the W/D/L (win/draw/loss) of each team's recent matches among a variety of splits (total, home, away, 1st half total, 1st half home, 1st half away). |
Assist Coverage Indicator
| Release Date | Feeds Affected | Benefit |
| 05/25/2023 | Season Info | Added an assists Boolean value at the season level to indicate whether assists are provided for a season.
|
Cup Round Data
| Release Date | Feeds Affected | Benefit |
| 03/20/2023 | Season Links | Added order, state, and winner_id to cup rounds in the Season Links endpoint.These new fields can be leveraged to determine the status, order, and winner of a cup round within a season/tournament. |
Pagination Update to Season Probabilities
| Release Date | Feeds Affected | Benefit |
| 03/03/2023 | Season Probabilities | Added pagination to the Season Probabilities endpoint for several APIs. Going forward, the first 200 events will be displayed. To retrieve further events additional query string parameters will be required. For example, to load the next 200 events you will need to append &start=200 to the call and to load the next 200 add &start=400 and so on. |
Category Data
| Release Date | Feeds Affected | Benefit |
| 01/20/2023 | Competition Info | Added the category element to the Competition Info endpoint. This includes category id, name, and country_code. The category will be represented by the country or International to better distinguish the country designation. |
'updated' Attributes for Push Feeds
| Release Date | Feeds Affected | Benefit |
| 11/29/2022 | Push Events | Added updated and updated_time flags to the Push Events feed. This update will better display which game events have been updated. |
'Lineups Confirmed' Attribute
| Release Date | Feeds Affected | Benefit |
| 10/11/2022 | Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities | Added a boolean lineups - confirmed attribute to all relevant sport event endpoints. This update will signify lineups have been entered and confirmed for a match. |
Venue Attribute
| Release Date | Feeds Affected | Benefit |
| 09/12/2022 | Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Info Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities | Added a boolean venue attribute to all relevant summary and season endpoints. This will indicate whether venue information is available for a certain match. |
Added Competition Sport Event Number
| Release Date | Feeds Affected | Benefit |
| 08/18/2022 | Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities | Added a competition_sport_event_number attribute to relevant match and season endpoints. This attribute helps to support tournaments with fixed match numbers, such as the World Cup. |
Order Added to Stages (Season Links)
| Release Date | Feeds Affected | Benefit |
| 07/12/2022 | Season Links | Added order to stages in the Season Links endpoint. This mirrors the behavior of the Season Info endpoint, providing a structure of stages (e.g., cup -> playoffs). |
'Sport Events Created' Endpoint
| Release Date | Feeds Affected | Benefit |
| 06/29/2022 | Sport Events Created | Our new Sport Events Created endpoint provides a list of all events created within the last 24 hours. Send requests to this endpoint as needed to assist in locating and storing newly created events. |
Coverage Enhancement
| Release Date | Feeds Affected | Benefit |
| 06/13/2022 | Match-level feeds | Added handling to support venue data population at the match level for tournaments without venue info for all matches. For example, we now support venue association for a finals match without the need for previous rounds' venues. |
'Season Transfers' Endpoint
| Release Date | Feeds Affected | Benefit |
| 05/23/2022 | Season Players Transfers | Added a Season Players Transfers endpoint to display changes in player roles (transfers/loans/new first-team players) in a given season. |
Added 'start date' for Players
| Release Date | Feeds Affected | Benefit |
| 05/18/2022 | Missing Players | Added a start date for each injury/absence in the Missing Players feed, allowing for a timeline of their absence. |
Ball Situation Status
| Release Date | Feeds Affected | Benefit |
| 05/12/2022 | Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timelines Push Events Push Statistics Live Probabilities Sport Event Probabilities Timeline Probabilities | Added a data point (match_situation) to display the ball situation during a live match (safe, dangerous, attack). |
Virtual Competitor Signifier
| Release Date | Feeds Affected | Benefit |
| 01/24/2022 | Season Competitors | Added a virtual competitor signifier to the Season Competitors feed. |
Seasonal Statistics
| Release Date | Feeds Affected | Benefit |
| 01/04/2022 | Season Over/Under Statistics | Added support for 1st half and 2nd half totals in the Season Over/Under Statistics feed. |
'Season Over/Under Statistics' Endpoint
| Release Date | Feeds Affected | Benefit |
| 11/09/2021 | Season Over/Under Statistics | Added data points to support the new Season Over/Under Statistics feed. |
'Competitor Merge Mappings' Endpoint
| Release Date | Feeds Affected | Benefit |
| 11/02/2021 | Competitor Merge Mappings | Added data points to support the new Competitor Merge Mappings feed. |
Competition Gender
| Release Date | Feeds Affected | Benefit |
| 11/02/2021 | Competition Info Competitions Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Player Summaries Season Info Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities | Added competition gender to several endpoints. |
Category Info
| Release Date | Feeds Affected | Benefit |
| 11/02/2021 | Competitions | Added category id, category name, and category country_code to the Competitions feed. |
Pagination Update
| Release Date | Feeds Affected | Benefit |
| 10/15/2021 | Daily Summaries Live Summaries Season Summaries Sport Events Updated | Added a pagination support description for the following feeds: Daily Summaries, Live Summaries, Season Summaries, Sport Events Updated. |
Standings Types
| Release Date | Feeds Affected | Benefit |
| 10/06/2021 | Season Standings | Added support for additional standings types. |
Probability Match Times
| Release Date | Feeds Affected | Benefit |
| 09/22/2021 | Live Probabilities Sport Event Probabilities Timeline Probabilities | Added match_time for relevant Probability feeds. |
Season Endpoints
| Release Date | Feeds Affected | Benefit |
| 08/20/2021 | Season Competitors Season Players Seasonal Competitor Players | Added data points in support of the new feeds. |
Team & Player Stats
| Release Date | Feeds Affected | Benefit |
| 08/20/2021 | League Timeline | Added additional statistics for teams: ball_possessions, blocked_shots, corner_kicks, fouls, fouls_suffered, offsides, saves, shots, shots_off_goal, shots_on_goal, substitutions. Added additional statistics for players: corner_kicks, fouls_suffered, offsides, own_goals, shots. |
Probability Package
| Release Date | Feeds Affected | Benefit |
| 05/20/2021 | Live Probabilities Season Outright Probabilities Sport Event Probabilities Sport Event Upcoming Probabilities Timeline Probabilities | Added data points to support the addition of the probabilities package feeds. |
'Season Links' Endpoint
| Release Date | Feeds Affected | Benefit |
| 05/20/2021 | Season Links | Added data points to support the addition of the Season Links feed. |
Stoppage Time
| Release Date | Feeds Affected | Benefit |
| 05/20/2021 | League Timeline Live Timelines Live Timelines Delta Sport Event Timelines Push Events | Added stoppage_time_clock to the timeline feeds and push events. |
Aggregate Scores
| Release Date | Feeds Affected | Benefit |
| 05/20/2021 | Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Push Events Push Statistics | Added aggregate away and home scores, and aggregate winner info. |
Standings Updates
| Release Date | Feeds Affected | Benefit |
| 10/07/2020 | Season Standings | Added group comment text and competitor form to the Season Standings feed. |
Match Substitution Stats
| Release Date | Feeds Affected | Benefit |
| 10/07/2020 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Summaries Sport Event Summary Sport Event Timeline Push Statistics | Added substitutions statistics to all summary and timeline feeds. |
'Season Schedules' Endpoint
| Release Date | Feeds Affected | Benefit |
| 07/07/2020 | Season Schedules | Added data points to support the new Season Schedules feed. |
Competitor Data
| Release Date | Feeds Affected | Benefit |
| 07/07/2020 | Seasonal Competitor Statistics | Added competitor data points to the Seasonal Competitor Statistics feed. |
Match Tie Boolean Value
| Release Date | Feeds Affected | Benefit |
| 07/07/2020 | Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Push Events Push Statistics | Added match_tie boolean value to sport_event_status. |
Season Data
| Release Date | Feeds Affected | Benefit |
| 04/30/2020 | Season Info | Added the following data points: competition_status and competitor other_season_id. |
Venue Update
| Release Date | Feeds Affected | Benefit |
| 04/30/2020 | Competitor Summaries Competitor vs Competitor Daily Summaries League Timeline Live Summaries Live Timelines Live Timelines Delta Player Summaries Season Info Season Lineups Season Probabilities Season Schedules Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline Push Events Push Statistics | Added the following venue data points: changed, reduced_capacity, and reduced_capacity_max. |
Leaders Endpoint Update
| Release Date | Feeds Affected | Benefit |
| 04/30/2020 | Season Leaders | Added player multiple_competitors to the Season Leaders feed to denote when a player has played for multiple teams. |
Group IDs
| Release Date | Feeds Affected | Benefit |
| 04/30/2020 | Season Standings | Updated group ids in the Season Standings feed to include “sr:group:” |
'League Timeline' Endpoint
| Release Date | Feeds Affected | Benefit |
| 03/17/2020 | League Timeline | Added data points in support of the new League Timeline feed. |
Push Feeds Release
| Release Date | Feeds Affected | Benefit |
| 03/09/2020 | Push Events Push Statistics | Added data points in support of the new Push Events and Push Statistics feeds |
Round Updates
| Release Date | Feeds Affected | Benefit |
| 01/08/2020 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline | Added additional round data, including: cup_round_number_of_sport_events, cup_round_sport_event_number, and other_sport_event_id. Added ground – neutral boolean flag. |
Lineup Availability Support
| Release Date | Feeds Affected | Benefit |
| 09/30/2019 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Info Season Lineups Season Probabilities Season Summaries Sport Event Lineups Sport Event Summary Sport Event Timeline | Added the Lineup Availability data point for Sport Event Properties. |
Missed Penalty Shots
| Release Date | Feeds Affected | Benefit |
| 09/30/2019 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Player Summaries Season Summaries Sport Event Summary Sport Event Timeline | Added the Penalties Missed data point. |
Seasonal Competitor Stats
| Release Date | Feeds Affected | Benefit |
| 09/30/2019 | Seasonal Competitor Statistics | Added the following data points: Goals Conceded First Half, Goals Conceded Second Half, Goals Scored First Half, and Goals Scored Second Half. |
API Release
| Release Date | Feeds Affected | Benefit |
| 07/23/2019 | All | Initial release of Soccer v4. |