Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Find all updates to the Tennis v3 API and its documentation

Sets Won & Sets Lost

Release DateFeeds AffectedBenefit
02/12/2024Season StandingsAdded 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 DateFeeds AffectedBenefit
08/30/2023Season InfoAdded 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 DateFeeds AffectedBenefit
08/28/2023Sport Events CreatedAdded 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 DateFeeds AffectedBenefit
03/28/2023Competitions by CategoryAdded 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 DateFeeds AffectedBenefit
03/20/2023Season LinksAdded 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 DateFeeds AffectedBenefit
03/03/2023Season ProbabilitiesAdded 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 DateFeeds AffectedBenefit
01/20/2023Competition InfoAdded 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 DateFeeds AffectedBenefit
11/29/2022Push EventsAdded 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 DateFeeds AffectedBenefit
09/13/2022Competitor 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 DateFeeds AffectedBenefit
08/23/2022Competitor 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 DateFeeds AffectedBenefit
07/21/2022Competitor 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 DateFeeds AffectedBenefit
06/29/2022Sport Events CreatedOur 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 DateFeeds AffectedBenefit
11/03/2021Competition InfoAdded alternative_name attribute to provide common tournament names.

'Season Standings' Endpoint

Release DateFeeds AffectedBenefit
11/03/2021Season StandingsAdded data points in support of the new Season Standings feed.

Surface Type

Release DateFeeds AffectedBenefit
11/03/2021Season InfoAdded surface type for complexes.

Bracket Numbers & Seed Info

Release DateFeeds AffectedBenefit
11/03/2021Season InfoAdded bracket number, qualification path, and seed at the competitor level for relevant tournaments.

Pagination Update

Release DateFeeds AffectedBenefit
10/15/2021Daily 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 DateFeeds AffectedBenefit
06/04/2021Doubles 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 DateFeeds AffectedBenefit
02/24/2021Push Events
Push Statistics
Added support for the Push Events and Push Statistics feeds.

API Release

Release DateFeeds AffectedBenefit
12/03/2020AllInitial release of Tennis v3.