Find all updates to the Tennis v3 API and its documentation
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: - Number of Competitors - Number of Qualified Competitors - Number of Scheduled Matches |
<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. |