Find all updates to the Tennis v3 API and its documentation
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"
},Broadcast Channel
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 05/08/2025 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline | We've added support for broadcast channels in our Tennis API. The attribute channel.name will now be present at the match level, and represents the broadcast network for a match's tournament. |
{
"generated_at": "2025-05-08T14:31:16+00:00",
"sport_event": {
"id": "sr:sport_event:59383231",
"start_time": "2025-03-31T09:30:00+00:00",
"start_time_confirmed": true,
"sport_event_context": {
"sport": {
"id": "sr:sport:5",
"name": "Tennis"
},
"category": {
"id": "sr:category:3",
"name": "ATP"
},
"competition": {
"id": "sr:competition:3007",
"name": "ATP Bucharest, Romania Men Singles",
"parent_id": "sr:competition:3005",
"type": "singles",
"gender": "men",
"level": "atp_250"
},
"season": {
"id": "sr:season:124323",
"name": "ATP Bucharest, Romania Men Singles 2025",
"start_date": "2025-03-30",
"end_date": "2025-04-06",
"year": "2025",
"competition_id": "sr:competition:3007"
},
"stage": {
"order": 2,
"type": "cup",
"phase": "stage_1_playoff",
"start_date": "2025-03-31",
"end_date": "2025-04-06",
"year": "2025"
},
"round": {
"name": "round_of_32"
},
"groups": [
{
"id": "sr:cup:172213",
"name": "2025 Bucharest, Romania"
}
],
"mode": {
"best_of": 3
}
},
"coverage": {
"type": "sport_event",
"sport_event_properties": {
"enhanced_stats": false,
"scores": "live",
"detailed_serve_outcomes": true,
"play_by_play": true
}
},
"competitors": [
{
"id": "sr:competitor:97231",
"name": "Djere, Laslo",
"country": "Serbia",
"country_code": "SRB",
"abbreviation": "DJE",
"qualifier": "home",
"bracket_number": 15
},
{
"id": "sr:competitor:392066",
"name": "Navone, Mariano",
"country": "Argentina",
"country_code": "ARG",
"abbreviation": "NAV",
"qualifier": "away",
"seed": 7,
"bracket_number": 16
}
],
"venue": {
"id": "sr:venue:65939",
"name": "Central Court",
"city_name": "Bucharest",
"country_name": "Romania",
"country_code": "ROU",
"timezone": "Europe/Bucharest"
},
"channels": [
{
"name": "Tennis Channel US"
}
],
"estimated": false
},<sport_event id="sr:sport_event:59383231" start_time="2025-03-31T09:30:00+00:00" start_time_confirmed="true" estimated="false">
<sport_event_context>
<sport id="sr:sport:5" name="Tennis"/>
<category id="sr:category:3" name="ATP"/>
<competition id="sr:competition:3007" name="ATP Bucharest, Romania Men Singles" parent_id="sr:competition:3005" type="singles" gender="men" level="atp_250"/>
<season id="sr:season:124323" name="ATP Bucharest, Romania Men Singles 2025" start_date="2025-03-30" end_date="2025-04-06" year="2025" competition_id="sr:competition:3007"/>
<stage order="2" type="cup" phase="stage_1_playoff" start_date="2025-03-31" end_date="2025-04-06" year="2025"/>
<round name="round_of_32"/>
<groups>
<group id="sr:cup:172213" name="2025 Bucharest, Romania"/>
</groups>
<mode best_of="3"/>
</sport_event_context>
<coverage type="sport_event">
<sport_event_properties enhanced_stats="false" scores="live" detailed_serve_outcomes="true" play_by_play="true"/>
</coverage>
<competitors>
<competitor id="sr:competitor:97231" name="Djere, Laslo" country="Serbia" country_code="SRB" abbreviation="DJE" qualifier="home" bracket_number="15"/>
<competitor id="sr:competitor:392066" name="Navone, Mariano" country="Argentina" country_code="ARG" abbreviation="NAV" qualifier="away" seed="7" bracket_number="16"/>
</competitors>
<venue id="sr:venue:65939" name="Central Court" city_name="Bucharest" country_name="Romania" country_code="ROU" timezone="Europe/Bucharest"/>
<channels>
<channel name="Tennis Channel US"/>
</channels>
</sport_event>Season Data
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 01/01/2025 | All Endpoints | We've updated our Tennis API coverage for 2025. These updates reflect adjustments in our partnerships and our continued focus on delivering reliable, high-quality data for the most impactful competitions. The updated coverage details will be reflected in the Coverage Matrix as they take effect.
|
Sets Won & Sets Lost
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 02/12/2024 | Season Standings | Added sets won (sets_won) and sets lost (sets_lost) to the Season Standings endpoint. |
<season_standings
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://schemas.sportradar.com/sportsapi/tennis/v3" generated_at="2024-02-01T14:02:56+00:00" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/tennis/v3 https://d1woxfzdkvuts1.cloudfront.net/bsa-6659/tennis/v3/schemas/season_standings.xsd">
<season_standing tie_break_rule="1. Number of matches 2. Head to Head 3. Highest percentage of sets won 4. Highest percentage of games won" type="total" round="3">
<groups>
<group id="sr:league:70437" name="Tour Finals, Green Group" live="false" group_name="Green Group">
<stage order="1" type="league" phase="regular season" start_date="2023-11-12" end_date="2023-11-18" year="2023"/>
<standings>
<standing rank="1" played="3" win="3" loss="0" sets_won="6" sets_lost="2">
<competitor id="sr:competitor:225050" name="Sinner, Jannik" country="Italy" country_code="ITA" abbreviation="SIN"/>
</standing>
<standing rank="2" played="3" win="2" loss="1" sets_won="5" sets_lost="4">
<competitor id="sr:competitor:14882" name="Djokovic, Novak" country="Serbia" country_code="SRB" abbreviation="DJO"/>
</standing>
<standing rank="3" played="3" win="1" loss="2" sets_won="2" sets_lost="4">
<competitor id="sr:competitor:429603" name="Rune, Holger" country="Denmark" country_code="DNK" abbreviation="RUN"/>
</standing>
<standing rank="4" played="1" win="0" loss="1" sets_won="1" sets_lost="2">
<competitor id="sr:competitor:158896" name="Hurkacz, Hubert" country="Poland" country_code="POL" abbreviation="HUR"/>
</standing>
<standing rank="5" played="2" win="0" loss="2" sets_won="0" sets_lost="2">
<competitor id="sr:competitor:122366" name="Tsitsipas, Stefanos" country="Greece" country_code="GRC" abbreviation="TSI"/>
</standing>
</standings>
</group>
<group id="sr:league:70439" name="Tour Finals, Red Group" live="false" group_name="Red Group">
<stage order="1" type="league" phase="regular season" start_date="2023-11-12" end_date="2023-11-18" year="2023"/>
<standings>
<standing rank="1" played="3" win="2" loss="1" sets_won="5" sets_lost="2">
<competitor id="sr:competitor:407573" name="Alcaraz, Carlos" country="Spain" country_code="ESP" abbreviation="ALC"/>
</standing>
<standing rank="2" played="3" win="2" loss="1" sets_won="4" sets_lost="2">
<competitor id="sr:competitor:163504" name="Medvedev, Daniil" country="Neutral" abbreviation="MED"/>
</standing>
<standing rank="3" played="3" win="2" loss="1" sets_won="4" sets_lost="3">
<competitor id="sr:competitor:57163" name="Zverev, Alexander" country="Germany" country_code="DEU" abbreviation="ZVE"/>
</standing>
<standing rank="4" played="3" win="0" loss="3" sets_won="0" sets_lost="6">
<competitor id="sr:competitor:106755" name="Rublev, Andrey" country="Neutral" abbreviation="RUB"/>
</standing>
</standings>
</group>
</groups>
</season_standing>
</season_standings>{
"generated_at":"2024-02-01T14:19:05+00:00",
"standings":[
{
"tie_break_rule":"1. Number of matches\r\n2. Head to Head\r\n3. Highest percentage of sets won\r\n4. Highest percentage of games won",
"type":"total",
"groups":[
{
"stage":{
"order":1,
"type":"league",
"phase":"regular season",
"start_date":"2023-11-12",
"end_date":"2023-11-18",
"year":"2023"
},
"id":"sr:league:70437",
"name":"Tour Finals, Green Group",
"live":false,
"standings":[
{
"rank":1,
"played":3,
"win":3,
"loss":0,
"competitor":{
"id":"sr:competitor:225050",
"name":"Sinner, Jannik",
"country":"Italy",
"country_code":"ITA",
"abbreviation":"SIN"
},
"sets_won":6,
"sets_lost":2
},
{
"rank":2,
"played":3,
"win":2,
"loss":1,
"competitor":{
"id":"sr:competitor:14882",
"name":"Djokovic, Novak",
"country":"Serbia",
"country_code":"SRB",
"abbreviation":"DJO"
},
"sets_won":5,
"sets_lost":4
},
{
"rank":3,
"played":3,
"win":1,
"loss":2,
"competitor":{
"id":"sr:competitor:429603",
"name":"Rune, Holger",
"country":"Denmark",
"country_code":"DNK",
"abbreviation":"RUN"
},
"sets_won":2,
"sets_lost":4
},
{
"rank":4,
"played":1,
"win":0,
"loss":1,
"competitor":{
"id":"sr:competitor:158896",
"name":"Hurkacz, Hubert",
"country":"Poland",
"country_code":"POL",
"abbreviation":"HUR"
},
"sets_won":1,
"sets_lost":2
},
{
"rank":5,
"played":2,
"win":0,
"loss":2,
"competitor":{
"id":"sr:competitor:122366",
"name":"Tsitsipas, Stefanos",
"country":"Greece",
"country_code":"GRC",
"abbreviation":"TSI"
},
"sets_won":0,
"sets_lost":2
}
],
"group_name":"Green Group"
},
{
"stage":{
"order":1,
"type":"league",
"phase":"regular season",
"start_date":"2023-11-12",
"end_date":"2023-11-18",
"year":"2023"
},
"id":"sr:league:70439",
"name":"Tour Finals, Red Group",
"live":false,
"standings":[
{
"rank":1,
"played":3,
"win":2,
"loss":1,
"competitor":{
"id":"sr:competitor:407573",
"name":"Alcaraz, Carlos",
"country":"Spain",
"country_code":"ESP",
"abbreviation":"ALC"
},
"sets_won":5,
"sets_lost":2
},
{
"rank":2,
"played":3,
"win":2,
"loss":1,
"competitor":{
"id":"sr:competitor:163504",
"name":"Medvedev, Daniil",
"country":"Neutral",
"abbreviation":"MED"
},
"sets_won":4,
"sets_lost":2
},
{
"rank":3,
"played":3,
"win":2,
"loss":1,
"competitor":{
"id":"sr:competitor:57163",
"name":"Zverev, Alexander",
"country":"Germany",
"country_code":"DEU",
"abbreviation":"ZVE"
},
"sets_won":4,
"sets_lost":3
},
{
"rank":4,
"played":3,
"win":0,
"loss":3,
"competitor":{
"id":"sr:competitor:106755",
"name":"Rublev, Andrey",
"country":"Neutral",
"abbreviation":"RUB"
},
"sets_won":0,
"sets_lost":6
}
],
"group_name":"Red Group"
}
],
"round":3
}
]
}Season Data
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 08/30/2023 | Season Info | Added three new data points to the season level of competitions:
|
<info prize_currency="£" prize_money="16077000" surface="grass"
complex="AELTC Wimbledon Qualifying and Community Sports Ground"
complex_id="sr:complex:64265" number_of_competitors="236"
number_of_qualified_competitors="128" number_of_scheduled_matches="242"/> "info": {
"prize_currency": "£",
"prize_money": 16077000,
"surface": "grass",
"complex": "AELTC Wimbledon Qualifying and Community Sports Ground",
"complex_id": "sr:complex:64265",
"number_of_competitors": 236,
"number_of_qualified_competitors": 128,
"number_of_scheduled_matches": 242
}
},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"
},'Competitions by Category' Endpoint
| Release Date | Feeds Affected | Benefit |
| 03/28/2023 | Competitions by Category | Added a new Competitions by Category endpoint. This endpoint can be used to retrieve all competitions within a certain category/tournament, rather than the complete competition list found in Competitions. For example, you may now retrieve only ATP, ITF, or WTA competitions. |
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. |
Seed & Bracket Information
| Release Date | Feeds Affected | Benefit |
| 09/13/2022 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Info Season Summaries Sport Event Summary Sport Event Timeline |
Added competitor seed and bracket\_number to all Summaries and Timeline endpoints. This allows for more efficient access to a competitor's seed and bracket number in a tournament. |
'Competitor Merge Mappings' Endpoint
| Release Date | Feeds Affected | Benefit |
| 08/23/2022 | Competitor Merge Mappings Player 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. Also added a Player Merge Mappings endpoint to the Aussie Rules Football API. |
Estimated Start Time
| Release Date | Feeds Affected | Benefit |
| 07/21/2022 | Competitor Summaries Competitor vs Competitor Daily Summaries Live Summaries Season Summaries Seasonal Probabilities Sport Event Summary Sport Event Timeline Live Probabilities Sport Event Probabilities Timeline Probabilities |
Added an estimated boolean attribute to display whether an estimated start time for a match has been entered. |
'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. |
Tournament Alternative Names
| Release Date | Feeds Affected | Benefit |
| 11/03/2021 | Competition Info | Added alternative\_name attribute to provide common tournament names. |
'Season Standings' Endpoint
| Release Date | Feeds Affected | Benefit |
| 11/03/2021 | Season Standings | Added data points in support of the new Season Standings feed. |
Surface Type
| Release Date | Feeds Affected | Benefit |
| 11/03/2021 | Season Info | Added surface type for complexes. |
Bracket Numbers & Seed Info
| Release Date | Feeds Affected | Benefit |
| 11/03/2021 | Season Info | Added bracket number, qualification path, and seed at the competitor level for relevant tournaments. |
Pagination Update
| Release Date | Feeds Affected | Benefit |
| 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. |
Probability Package
| Release Date | Feeds Affected | Benefit |
| 06/04/2021 | Doubles Competitions Played Season Links 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. |
Push Feeds
| Release Date | Feeds Affected | Benefit |
| 02/24/2021 | Push Events Push Statistics |
Added support for the Push Events and Push Statistics feeds. |
API Release
| Release Date | Feeds Affected | Benefit |
| 12/03/2020 | All | Initial release of Tennis v3. |