⏱️
Update Frequency
TTL/Cache: 1 second
Data Updates (Tier 1): Updates are made during live play and up to one hour after the match

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 competition `men`, `women`, `mixed`, `female`, `male`
`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 competition `grand_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 stage `cup`, `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 competitor `male`, `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 match `home`, `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 competitor `male`, `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 available `live`, `post` (Post-match)

Game State

Attribute	Parent Element	Type	Description
`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 game `server_winner`, `receiver_winner`, `ace`, `double_fault`
`point_type`	`sport_event_status` - `game_state`	String	Type of point scored `game`, `break`, `set`, `match`
`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.
`count_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 match `walkover`, `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

Match Timeline

Attribute	Parent Element	Type	Description
`away_score`	`timeline` - `event`	Integer	Away competitor point score ex. `0`, `15`, `30`, `40`
`competitor`	`timeline` - `event`	String	Designation of a competitor for a timeline event `home`, `away`
`first_serve_fault`	`timeline` - `event`	Boolean	Signifies the first serve of a point was a fault when `true`
`home_score`	`timeline` - `event`	Integer	Home competitor point score ex. `0`, `15`, `30`, `40`
`id`	`timeline` - `event`	Integer	Unique ID for a timeline event ex. `1804315823`
`period`	`timeline` - `event`	Integer	Set number of a timeline event. Populates for each `period_score` event.
`period_name`	`timeline` - `event`	String	Period name of a timeline event, appearing at the beginning of a period ex. `2nd_set`
`reason`	`timeline` - `event`	String	Reason for a `match_suspended` event `toilet_break`, `bad_weather`, `trainer_called`
`result`	`timeline` - `event`	String	Result of an event `ace`, `double_fault`, `server_won`, `receiver_won`, `unknown`
`result`	`timeline` - `event`	String	Result of an event `ace`, `double_fault`, `server_won`, `receiver_won`, `unknown`
`server`	`timeline` - `event`	String	Server for a timeline event `home`, `away`
`time`	`timeline` - `event`	Date-time	Timestamp of a timeline event ex. `2024-04-16T20:49:49+00:00`
`type`	`timeline` - `event`	String	Type of timeline event. See our Tennis OpenAPI for a complete list of event types under enum_event_type ex. `match_started`, `point`, `match_suspended`

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`