get https://api.sportradar.com/tennis//v3//seasons//summaries.
Returns the sport event summaries for a given season
Update FrequencyTTL/Cache: 300 seconds
Data Updates (Tier 1): Updates are made during live play and up to one hour after the match
Pagination NotePagination will often be required to pull all data within this feed. By default, the feed will return 200 sport events.
Data Points
Category & Sport
Attribute | Parent Element | Type | Description |
---|---|---|---|
country_code | sport_event_context - category | String | Country code for a sport event's category |
id | sport_event_context - category | String | Unique category ID for a sport event. See our FAQ for a list of available categories/tours. ex. sr:category:3 (ATP) |
name | sport_event_context - category | String | Name for a sport event's category. See our FAQ for a list of available categories/tours. ex. ATP , WTA , Billie Jean King Cup |
id | sport_event_context - sport | String | Unique sport ID for a sport event ex. sr:sport:5 |
name | sport_event_context - sport | String | Name for a sport event's sport ex. Tennis |
Competition
Attribute | Parent Element | Type | Description |
---|---|---|---|
gender | sport_event_context - competition | String | Gender for a competitionmen , women , mixed |
id | sport_event_context - competition | String | Unique ID for a competition ex. sr:competition:2555 (Wimbledon Men Singles) |
level | sport_event_context - competition | String | Level of a competitiongrand_slam , atp_1000 , atp_500 , atp_250 , wta_premier , wta_international , atp_world_tour_finals , wta_championships , atp_next_generation , wta_elite_trophy , wta_master , wta_500 , wta_250 , wta_1000 , wta_125 |
name | sport_event_context - competition | String | Name of a competition ex. Wimbledon Men Singles , WTA Monterrey, Mexico Women Doubles |
parent_id | sport_event_context - competition | String | Unique parent ID for a competition. ex. sr:competition:2553 is used to group all Wimbledon competitions. |
type | sport_event_context - competition | String | Type of a competition ex. singles , doubles , mixed , mixed_doubles |
best_of | sport_event_context - mode | Integer | Number of sets in a 'best of' competition |
Groups
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | sport_event_context - groups - group | String | Unique ID for a sport event's group ex. sr:league:150657 (2024 Wimbledon, London, Great Britain) |
name | sport_event_context - groups - group | String | Name of a sport event's group ex. 2024 Wimbledon, London, Great Britain |
group_name | sport_event_context - groups - group | String | Abbreviated name of a sport event's group |
Season
Attribute | Parent Element | Type | Description |
---|---|---|---|
competition_id | sport_event_context - season | String | Unique ID for the competition a season belongs to ex. sr:competition:2555 (Wimbledon Men Singles) |
disabled | sport_event_context - season | Boolean | Signifies a season has been disabled when true |
end_date | sport_event_context - season | Date | End date of a season ex. 2025-07-13 |
id | season | String | Unique ID for a season ex. sr:season:120983 (Wimbledon Men Singles 2025) |
name | sport_event_context - season | String | Name of a season ex. Wimbledon Men Singles 2025 |
start_date | sport_event_context - season | Date | Start date of a season ex. 2025-06-23 |
year | sport_event_context - season | String | Year of a season ex. 24/25 or 2025 |
Stages
Attribute | Parent Element | Type | Description |
---|---|---|---|
end_date | sport_event_context - stage | Date | End date of a sport event's stage ex. 2024-07-14 |
order | sport_event_context - stage | Integer | Order of a stage within a season |
phase | sport_event_context - stage | String | Name of a sport event's stage ex. stage_1_playoff , qualification See the enum_phase entry in our Tennis OpenAPI spec for a complete list of valid phase enum values |
start_date | sport_event_context - stage | Date | Start date of a sport event's stage ex. 2024-06-24 |
type | sport_event_context - stage | String | Type of a match's stagecup , league |
year | sport_event_context - stage | String | Year of a match's stage ex. 23/24 or 2024 |
Rounds
Attribute | Parent Element | Type | Description |
---|---|---|---|
name | sport_event_context - round | String | Name of a match's round. See our FAQ for a complete list of values and their definitions. ex. round_of_64 , quarterfinal , final |
number | sport_event_context - round | Integer | Number of a match's round |
Competitor
Competitors can be a player, a doubles team, or a national team
Attribute | Parent Element | Type | Description |
---|---|---|---|
abbreviation | competitors - competitor | String | Abbreviation for a competitor name ex. PAU (Tommy Paul) or G/M ('Glasspool L / Middelkoop M' doubles team) |
bracket_number | competitors - competitor | Integer | Indicates the position in the bracket that the competitor is placed |
country | competitors - competitor | String | Country of a competitor ex. USA |
country_code | competitors - competitor | String | Country code of a competitor ex. USA |
gender | competitors - competitor | String | Gender for a competitormale , female |
id | competitors - competitor | String | Unique ID for a competitor ex. sr:competitor:138546 |
name | competitors - competitor | String | Name for a competitor ex. Paul, Tommy or Glasspool L / Middelkoop M (doubles team) |
qualifier | competitors - competitor | String | Designation of a competitor for a matchhome , away |
seed | competitors - competitor | Integer | Seed number for a competitor in a match |
virtual | competitors - competitor | Boolean | Signifies a competitor is virtual when true . Used for placeholder players/teams in TBD vs TBD matchups. |
Player
Competitors will appear under a
players
node when part of a doubles competition.
Attribute | Parent Element | Type | Description |
---|---|---|---|
abbreviation | competitor - players - player | String | Abbreviation for a competitor name ex. PAU (Tommy Paul) |
country | competitor - players - player | String | Country of a competitor ex. USA |
country_code | competitor - players - player | String | Country code of a competitor ex. USA |
date_of_birth | competitor - players - player | Date | Date of birth of a player ex. 1994-07-05 |
gender | competitor - players - player | String | Gender for a competitormale , female |
height | competitor - players - player | Integer | Height of a player in centimeters ex. 193 |
id | competitor - players - player | String | Unique ID for a competitor ex. sr:competitor:138546 |
name | competitor - players - player | String | Name for a competitor ex. Paul, Tommy |
nationality | competitor - players - player | String | Nationality of a player ex. Japan |
virtual | competitor - players - player | Boolean | Signifies a competitor is virtual when true . Used for placeholder players/teams in TBD vs TBD matchups. |
Coverage Properties
Attribute | Parent Element | Type | Description |
---|---|---|---|
type | sport_event - coverage | String | Type of coverage for a match or competition. When type=sport_event coverage is described within sport_event_properties . If type="competition" coverage is described within sport_event_properties and competition_properties .sport_event , competition |
detailed_serve_outcomes | sport_event - coverage - sport_event_properties | Boolean | Signifies detailed serve outcomes are available for a match when true |
extended_stats | sport_event - coverage - sport_event_properties | Boolean | Signifies extended stats are available for a match when true |
play_by_play | sport_event - coverage - sport_event_properties | Boolean | Signifies play-by-play events are available for a match when true |
scores | sport_event - coverage - sport_event_properties | String | Indicates when match scores are made availablelive , post (Post-match) |
Game State
Attribute | Parent Element | Type | Description |
---|---|---|---|
advantage | sport_event_status - game_state | String | Signifies the competitor with the advantage in the gamehome , away |
away_score | sport_event_status - game_state | Integer | Score for the away competitor in a game ex. 0 , 15 , 30 , 40 |
home_score | sport_event_status - game_state | Integer | Score for the home competitor in a game ex. 0 , 15 , 30 , 40 |
last_point_result | sport_event_status - game_state | String | Result of the last point in a gameserver_winner , receiver_winner , ace , double_fault |
point_type | sport_event_status - game_state | String | Type of point scoredgame , break , set , match |
serving | sport_event_status - game_state | String | Signifies the competitor currently servinghome , away |
tie_break | sport_event_status - game_state | Boolean | Signifies a match is in a tie break when true |
Sport Event
Attribute | Parent Element | Type | Description |
---|---|---|---|
estimated | sport_event | Boolean | When true , signifies a match has an estimated start time based on the time of a previous match at the same venue. |
id | sport_event | String | Unique ID of a match ex. sr:sport_event:51847153 |
parent_id | sport_event | String | Parent ID of a match ex. sr:sport_event:51847153 |
replaced_by | sport_event | String | An alternative sport event ID if the match is postponed and played at a later date ex. sr:sport_event:51847153 |
resume_time | sport_event | Date | An updated timestamp if there is a delay at the start or interruption during a match ex. 2024-03-26T20:00:00+00:00 |
start_time | sport_event | Date | Start time of a match ex. 2024-03-26T20:00:00+00:00 |
start_time_confirmed | sport_event | Boolean | Signifies the start time of a match is confirmed when true |
Sport Event - Channel
Attribute | Parent Element | Type | Description |
---|---|---|---|
name | sport_event - channels - channel | String | Name of a broadcast channel for a match's tournament ex. Tennis Channel US |
Sport Event Status
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_score | sport_event_status | Integer | Total score for the away competitor in a match |
decided_by_fed | sport_event_status | Boolean | Signifies a match result was decided by the federation when true . For example, incomplete due to crowd disruption |
home_score | sport_event_status | Integer | Total score for the home competitor in a match |
match_status | sport_event_status | String | Status within a match (sport event). Provides more detail on the state of a match when live than status ex. not_started , interrupted , 1st_set , walkover See our FAQ for a complete list of statuses and their definitions. |
scount_abandoned | sport_event_status | Boolean | Signifies a match was abandoned by a scout when true |
status | sport_event_status | String | Status of a sport event ex. not_started , live , ended , closed See our FAQ for a complete list of statuses and their definitions. |
winner_id | sport_event_status | String | Unique ID of the match winner ex. sr:competitor:138546 |
winning_reason | sport_event_status | String | Winning reason description for a matchwalkover , retirement , defaulted See our FAQ for more info |
Period Scores
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_score | sport_event_status - period_scores - period_score | Integer | Away competitor set score |
away_tiebreak_score | sport_event_status - period_scores - period_score | Integer | Away competitor tiebreak set score |
home_score | sport_event_status - period_scores - period_score | Integer | Home competitor set score |
home_tiebreak_score | sport_event_status - period_scores - period_score | Integer | Home competitor tiebreak set score |
number | sport_event_status - period_scores - period_score | Integer | Set number |
type | sport_event_status - period_scores - period_score | String | Period type ex. set |
Match Stats (Competitor)
See our Statistics FAQ Section for detailed descriptions of our tennis statistics
Attribute | Parent Element | Type | Description |
---|---|---|---|
aces | competitor - statistics | Integer | Number of aces for a competitor in a match |
backhand_errors | competitor - statistics | Integer | Number of backhand errors for a competitor in a match |
backhand_unforced_errors | competitor - statistics | Integer | Number of backhand unforced errors for a competitor in a match |
backhand_winners | competitor - statistics | Integer | Number of backhand winners for a competitor in a match |
breakpoints_won | competitor - statistics | Integer | Number of breakpoints won for a competitor in a match |
double_faults | competitor - statistics | Integer | Number of double faults for a competitor in a match |
drop_shot_unforced_errors | competitor - statistics | Integer | Number of drop shot unforced errors for a competitor in a match |
drop_shot_winners | competitor - statistics | Integer | Number of drop shot winners for a competitor in a match |
first_serve_points_won | competitor - statistics | Integer | Number of first serve points won for a competitor in a match |
first_serve_successful | competitor - statistics | Integer | Number of successful first serves for a competitor in a match |
forehand_errors | competitor - statistics | Integer | Number of forehand errors for a competitor in a match |
forehand_unforced_errors | competitor - statistics | Integer | Number of forehand unforced errors for a competitor in a match |
forehand_winners | competitor - statistics | Integer | Number of forehand winners for a competitor in a match |
games_won | competitor - statistics | Integer | Number of games won for a competitor in a match |
groundstroke_errors | competitor - statistics | Integer | Number of groundstroke errors for a competitor in a match |
groundstroke_unforced_errors | competitor - statistics | Integer | Number of groundstroke unforced errors for a competitor in a match |
groundstroke_winners | competitor - statistics | Integer | Number of groundstroke winners for a competitor in a match |
lob_unforced_errors | competitor - statistics | Integer | Number of lob unforced errors for a competitor in a match |
lob_winners | competitor - statistics | Integer | Number of lob winners for a competitor in a match |
max_games_in_a_row | competitor - statistics | Integer | Longest game win streak for a competitor in a match |
max_points_in_a_row | competitor - statistics | Integer | Longest point win streak for a competitor in a match |
overhead_stroke_errors | competitor - statistics | Integer | Number of overhead errors for a competitor in a match |
overhead_stroke_unforced_errors | competitor - statistics | Integer | Number of overhead unforced errors for a competitor in a match |
overhead_stroke_winners | competitor - statistics | Integer | Number of overhead winners for a competitor in a match |
points_won | competitor - statistics | Integer | Number of points won for a competitor in a match |
points_won_from_last_10 | competitor - statistics | Integer | Number of points won in the last 10 opportunities for a competitor in a match |
return_errors | competitor - statistics | Integer | Number of return errors for a competitor in a match |
return_winners | competitor - statistics | Integer | Number of return winners for a competitor in a match |
second_serve_points_won | competitor - statistics | Integer | Number of second serve points won for a competitor in a match |
second_serve_successful | competitor - statistics | Integer | Number of successful second serves for a competitor in a match |
service_games_won | competitor - statistics | Integer | Number of service games won for a competitor in a match |
service_points_lost | competitor - statistics | Integer | Number of service points lost for a competitor in a match |
service_points_won | competitor - statistics | Integer | Number of service points won for a competitor in a match |
tiebreaks_won | competitor - statistics | Integer | Number of tiebreaks won for a competitor in a match |
total_breakpoints | competitor - statistics | Integer | Number of total breakpoints for a competitor in a match |
volley_unforced_errors | competitor - statistics | Integer | Number of volley unforced errors for a competitor in a match |
volley_winners | competitor - statistics | Integer | Number of volley winners for a competitor in a match |
Venue
Attribute | Parent Element | Type | Description |
---|---|---|---|
capacity | venue | Integer | Capacity of a venue ex. 14820 |
changed | venue | Boolean | Signifies a venue has been changed when true |
city_name | venue | String | City name of a venue ex. London |
country_code | venue | String | Country code of a venue ex. ENG (England) |
country_name | venue | String | Country name of a venue ex. England |
id | venue | String | Unique ID of a venue ex. sr:venue:1846 |
map_coordinates | venue | String | Coordinates of a venue ex. 54.707924, 25.236942 |
name | venue | String | Name of a venue ex. Court 1 , Center Court , or Astana Arena |
reduced_capacity | venue | Boolean | Optional attribute signifying a venue has a restricted capacity when true |
reduced_capacity_max | venue | Integer | Value of a venue's restricted capacity |
timezone | venue | String | Timezone of a venue ex. Europe/London |