get
https://api.sportradar.com/tennis//v3//competitors//versus//summaries.
Provides past and upcoming match details between two competitors given two competitor IDs.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL/Cache: 60 seconds
Data Updates (Tier 1):
- Draw added within 3 hrs of official release; fixtures checked continuously
- Draw changes shown within 2 hrs; newly scheduled matches appear within 30 mins
- Complexes set shortly before the draw
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, 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 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, qualificationSee 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
Competitor info is available at the top of each file and for each individual match.
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
playersnode 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 statusex. not_started, interrupted, 1st_set, walkoverSee 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, closedSee 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, defaultedSee 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_id | venue | String | Unique ID of a city ex. sr:city:59 |
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 |