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

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

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.

'Competitor Merge Mappings' Endpoint

Release Date	Feeds Affected	Benefit
08/23/2022	Competitor Merge Mappings	Added the Competitor Merge Mappings endpoint to a variety of APIs. This feed provides the valid Sportradar Id in cases when two competitors have been merged into one. This feed was previously present in the Soccer API.

'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.

Category Updates

Release Date	Feeds Affected	Update
11/02/2021	Competitions	Added category id, category name, and category country_code to the Competitions feed.

Date of Birth

Release Date	Feeds Affected	Benefit
11/02/2021	Competitor Profile	Added date of birth for competitors/players.

Rankings Gender & Points

Release Date	Feeds Affected	Benefit
11/02/2021	Rankings	Added competitor points and gender to the Rankings endpoint.

Walkover Support

Release Date	Feeds Affected	Update
11/02/2021	Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Live Timelines Live Timelines Delta Season Summaries Sport Event Summary Sport Event Timeline Push Events	Added data point ‘winning_reason’ under ‘sport_event_status’ for events ending in a walkover.

Pagination Support

Release Date	Feeds Affected	Update
10/15/2021	Daily Summaries Season Summaries Sport Events Updated	Added a pagination support description for the following feeds: Daily Summaries, Season Summaries, Sport Events Updated.

Season Competitor Standings

Release Date	Feeds Affected	Update
09/09/2021	Season Competitors Season Links	Added data points to support the addition of season competitor and standings data.

Gender Distinction

Release Date	Feeds Affected	Update
10/23/2020	Competitions Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline	Added competition gender to several endpoints.

Venue Capacity

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

Group IDs Added to Standings

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

Removed `is_parent` Flag

Release Date	Feeds Affected	Update
11/08/2019	Competitions	Removed the is_parent flag.

Competition Data

Release Date	Feeds Affected	Update
11/08/2019	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 the Push Statistics feed.

'Rankings', 'Seasons', 'Push Events' Endpoints

Release Date	Feeds Affected	Update
11/08/2019	Rankings Seasons Push Events	Added data points to support the new Rankings, Seasons, and Push Events feeds.

'Competition Info' Endpoint

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

API Release

Release Date	Feeds Affected	Update
03/06/2019	All	Initial release for Badminton v2.