Change Log

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"
},

Round Info Additions

Date Feeds Affected Benefit

09/26/2023

Date	Feeds Affected	Benefit
09/26/2023	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline	Added data points related to tournament rounds to bring consistency across APIs. New data points include: Round - Cup Round Sport Event Number (`cup_round_sport_event_number`) Round - Cup Round Number of Sport Events (`cup_round_number_of_sport_events`) Round - Cup Round Id (`cup_round_id`) Round - Other Sport Event Id (`other_sport_event_id`) *when 2 legs only

Competitor Summaries

Competitor vs Competitor

Daily Summaries

Live Summaries

Season Probabilities

Season Summaries

Sport Event Summary

Sport Event Timeline

Added data points related to tournament
rounds to bring consistency across APIs.

New data points include:

Round - Cup Round Sport Event Number
(cup_round_sport_event_number)
Round - Cup Round Number of Sport Events
(cup_round_number_of_sport_events)
Round - Cup Round Id
(cup_round_id)
Round - Other Sport Event Id
(other_sport_event_id) *when 2 legs only

<round name="quarterfinal" other_sport_event_id="sr:sport_event:43573993" 
	cup_round_sport_event_number="2" cup_round_number_of_sport_events="2" 
	cup_round_id="sr:cup_round:1923693"/>

"round": {
    "name": "quarterfinal",
    "other_sport_event_id": "sr:sport_event:43573993",
    "cup_round_sport_event_number": 2,
    "cup_round_number_of_sport_events": 2,
    "cup_round_id": "sr:cup_round:1923693"
},

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"
        },
    ]
}

New Competitor Elements

Release Date	Feeds Affected	Update
03/08/2023	Competitor Profile Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Info Season Probabilities Season Standings Season Summaries Sport Event Summary Sport Event Timeline	Added ‘age_group’ and ‘gender’ to competitor elements in several endpoints.

Pagination Update

Release	Feeds Affected	Update
03/03/2023	Season Probabilities	Added pagination to the Season Probabilities endpoint. Going forward, the first 200 events will be displayed. To retrieve further events additional query string parameters will be required.

Release

Feeds Affected

Update

03/03/2023

Season Probabilities

Added pagination to the Season Probabilities endpoint.

Going forward, the first 200 events will be displayed. To retrieve further events additional query string parameters will be required.

Competition Info Feed Update

Release	Feeds Affected	Update
01/20/2023	Competition Info	Added category information (id, name, country_code) to the Competition Info endpoint.

Feed Added

Release	Feeds Affected	Update
08/22/2022	Competitor Merge Mappings	Added data points to support the new Competitor Merge Mappings endpoint.

Feed Added

Release	Feeds Affected	Update
06/28/2022	Sport Events Created	Added support for a new Sport Events Created endpoint.

New Boolean Attribute

Release	Feeds Affected	Update
04/20/2022	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Live Timelines Live Timelines Delta Season Summaries Sport Event Summary Sport Event Timeline	Added a ‘match_tie’ boolean attribute for relevant matches.

Competition Gender Added

Release	Feeds Affected	Update
02/04/2022	Competition Info Competitions Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Info Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline	Added competition gender to several endpoints.

FAQ Update

Release	Feeds Affected	Update
01/20/2022	None	Added a description on status behavior for an event which is not covered live.

Additional Standings Types

Release	Feeds Affected	Update
10/05/2021	Season Standings	Added support for additional standings types.

FAQ Update

Release	Feeds Affected	Update
10/05/2021	None	Added support for additional standings types.

New Feeds Added

Release	Feeds Affected	Update
09/14/2021	Season Competitions Season Links Seasons	Added seasonal data to support three new feeds.

Data Points Added

Release	Feeds Affected	Update
06/01/2020	Season Information	Added the following data points: competition_status, venue_reduced_capacity, and venue_reduced_capacity_max.

FAQ Update

Release	Feeds Affected	Update
06/01/2020	None	Added FAQ question denoting how group ids are handled.

Value Update

Release	Feeds Affected	Update
06/01/2020	Season Standings	Updated group ids in the Season Standings feed to include “sr:group:”

New Competition Info Feed

Release	Feeds Affected	Update
04/29/2019	Competition Info	Added support for the Competition Information endpoint.

Initial Release

Release	Feeds Affected	Update
03/20/2019	All	Initial Release for Field Hockey v2.