get https://api.sportradar.com///v3//competitors//versus//summaries.
Provides previous and upcoming games between two teams, including scoring information.
Update Frequency
60s Time To Live / Cache
Data Points
Category & Sport:
Attribute | Parent Element | Type | Description |
---|---|---|---|
country_code | sport_event_context - category | String | Country code for a sport event's category ex. ENG (England) |
id | sport_event_context - category | String | Unique category ID for a sport event ex. sr:category:83 |
name | sport_event_context - category | String | Name for a sport event's category ex. Rugby League |
id | sport_event_context - sport | String | Unique sport ID for a sport event ex. sr:sport:12 |
name | sport_event_context - sport | String | Name for a sport event's sport ex. Rugby |
Competition:
Attribute | Parent Element | Type | Description |
---|---|---|---|
gender | sport_event_context - competition | String | Gender for a competitionmen , women |
id | sport_event_context - competition | String | Unique ID for a competition ex. sr:competition:302 (Super League) |
name | sport_event_context - competition | String | Name of a competition ex. Super League , NRL, Women |
Groups:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | sport_event_context - groups - group | String | Unique ID for a sport event's group ex. sr:league:80301 (Super League 2024) |
name | sport_event_context - groups - group | String | Name of a sport event's group ex. Super League 2024 , Super League 2024, Playoffs |
group_name | sport_event_context - groups - group | String | Abbreviated name of a sport event's group ex. D |
Rounds:
Attribute | Parent Element | Type | Description |
---|---|---|---|
competition_sport_event_number | sport_event_context - round | Integer | Sport event number within a competition. Used for competitions that have fixed match numbers. |
cup_round_id | sport_event_context - round | String | Unique ID for a sport event's cup round ex. sr:cup_round:2120411 |
cup_round_number_of_sport_events | sport_event_context - round | Integer | Number of events in a sport event's round |
cup_round_sport_event_number | sport_event_context - round | Integer | Number within the cup_round of a match ID. For example, 1st leg of 2 |
name | sport_event_context - round | String | Name of a sport event's round ex. semifinal or final |
number | sport_event_context - round | Integer | Number of a sport event's round |
other_sport_event_id | sport_event_context - round | String | A linked sport event ID, typically in a two-legged tie ex. sr:sport_event:47395897 |
Seasons:
Attribute | Parent Element | Type | Description |
---|---|---|---|
competition_id | sport_event_context - season | String | Unique ID for the competition a sport event belongs to ex. sr:competition:302 (Super League) |
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 sport event's season ex. 2024-10-12 |
id | sport_event_context - season | String | Unique ID for a sport event's season ex. sr:season:112664 (Super League 2024) |
name | sport_event_context - season | String | Name of a sport event's season ex. Super League 2024 |
start_date | sport_event_context - season | Date | Start date of a sport event's season ex. 2024-02-15 |
year | sport_event_context - season | String | Year of a sport event's season ex. 2024 |
Stages:
Attribute | Parent Element | Type | Description |
---|---|---|---|
end_date | sport_event_context - stage | Date | End date of a sport event's stage ex. 2024-09-21 |
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. final_phase , knockout_stage , playoffs See the enum_phase entry in our Rugby OpenAPI specs 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-02-15 |
type | sport_event_context - stage | String | Type of a sport event's stagecup , league |
year | sport_event_context - stage | String | Year of a sport event's stage ex. 2024 |
Competitor:
Competitor info is available at the top of each file and for each individual match.
Attribute | Parent Element | Type | Description |
---|---|---|---|
abbreviation | competitors - competitor | String | Abbreviation for a competitor name ex. WGW (Wigan Warriors) |
age_group | competitors - competitor | String | Age group of a competitor, when applicable ex. U23 |
gender | competitors - competitor | String | Gender for a competitormale , female |
id | competitors - competitor | String | Unique ID for a competitor ex. sr:competitor:4233 (Wigan Warriors) |
name | competitors - competitor | String | Name for a competitor ex. Wigan Warriors |
qualifier | competitors - competitor | String | Designation of a competitor for a sport eventhome , away |
virtual | competitors - competitor | Boolean | Signifies a competitor is a virtual team whan true . Used for placeholder teams in TBD vs TBD matchups. |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | statistics - competitor - player | String | Unique ID of a player ex. sr:player:474906 |
name | statistics - competitor - player | String | Name of a player ex. Gallo, Thomas |
Sport Event:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | sport_event | String | Unique ID of a sport event ex. sr:sport_event:53800561 |
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:47395897 |
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 sport event ex. 2024-03-26T20:00:00+00:00 |
start_time_confirmed | sport_event | Boolean | Signifies the start time of a sport event is confirmed when true |
overall_conditions | sport_event_conditions - weather | String | Weather conditions for a sport eventgood , medium , bad , indoor , extreme |
pitch_conditions | sport_event_conditions - weather | String | Pitch conditions for a sport eventgood , medium , bad |
Sport Event - Coverage Properties:
Attribute | Parent Element | Type | Description |
---|---|---|---|
live | sport_event - coverage | Boolean | Signifies a sport event is covered live when true |
type | sport_event - coverage - property | String | Type of coverage for a sport event ex. boxscore , lineups , match_clock |
value | sport_event - coverage - property | Boolean | Signifies a coverage types is available when true For example, type="boxscore" value="true" signifies additional team and player stats are available for this sport event. See our FAQ for more info on coverage. |
Sport Event - Referee:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | sport_event_conditions - referees - referee | String | Unique ID for a referee ex. sr:referee:766676 |
name | sport_event_conditions - referees - referee | String | Name of a referee ex. Ridley, Christophe |
nationality | sport_event_conditions - referees - referee | String | Nationality of a referee ex. Wales |
country_code | sport_event_conditions - referees - referee | String | Country code of a referee ex. WAL |
type | sport_event_conditions - referees - referee | String | Type of a referee ex. main_referee |
Sport Event Status:
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_score | sport_event_status | Integer | Total score for the away team in the match |
away_normaltime_score | sport_event_status | Integer | Score for the away team in normal time |
home_score | sport_event_status | Integer | Total score for the home team in the match |
home_normaltime_score | sport_event_status | Integer | Score for the home team in normal time |
match_status | sport_event_status | String | Status within a match (sport event). Provides more detail on the state of a sport event when live than status ex. not_started , 1st_quarter , ended , cancelled See our FAQ for a complete list of statuses and their definitions. |
match_tie | sport_event_status | Boolean | Signifies a matched ended in a tie when true |
scount_abandoned | sport_event_status | Boolean | Signifies a sport event 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:4231 |
Period Scores:
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_score | sport_event_status - period_scores - period_score | Integer | Away team period score |
home_score | sport_event_status - period_scores - period_score | Integer | Home team period score |
number | sport_event_status - period_scores - period_score | Integer | Period number |
type | sport_event_status - period_scores - period_score | String | Period type ex. 1st_half , 2nd_half , pause , 1st_extra , 2nd_extra , extra_time_halftime , awaiting_extra , interrupted , overtime , regular_period |
Game Stats (Player):
Attribute | Parent Element | Type | Description |
---|---|---|---|
carries | player - statistics | Integer | Number of carries for a player in a match |
clean_breaks | player - statistics | Integer | Number of clean breaks for a player in a match |
meters_run | player - statistics | Integer | Number of meters run for a player in a match |
offloads | player - statistics | Integer | Number of offloads for a player in a match |
passes | player - statistics | Integer | Number of passes for a player in a match |
tackle_missed | player - statistics | Integer | Number of missed tackles for a player in a match |
tackles | player - statistics | Integer | Number of tackles for a player in a match |
try_assist | player - statistics | Integer | Number of try assists for a player in a match |
turnovers_won | player - statistics | Integer | Number of turnovers won for a player in a match |
Game Stats (Team):
Attribute | Parent Element | Type | Description |
---|---|---|---|
ball_possession | competitor - statistics | Integer | Percentage of team ball possession for a match |
carries | competitor - statistics | Integer | Number of carries for a team in a match |
clean_breaks | competitor - statistics | Integer | Number of clean breaks for a team in a match |
conversions | competitor - statistics | Integer | Number of conversions for a team in a match |
drop_goals | competitor - statistics | Integer | Number of drop goals for a team in a match |
lineouts_won | competitor - statistics | Integer | Number of lineouts won for a team in a match |
meters_run | competitor - statistics | Integer | Number of meters run for a team in a match |
offloads | competitor - statistics | Integer | Number of offloads for a team in a match |
passes | competitor - statistics | Integer | Number of passes for a team in a match |
penalties_conceded | competitor - statistics | Integer | Number of penalties conceded for a team in a match |
penalty_goals | competitor - statistics | Integer | Number of penalty goals for a team in a match |
red_cards | competitor - statistics | Integer | Number of red cards for a team in a match |
scrums_lost | competitor - statistics | Integer | Number of scrums lost for a team in a match |
scrums_won | competitor - statistics | Integer | Number of scrums won for a team in a match |
tackle_missed | competitor - statistics | Integer | Number of tackles missed for a team in a match |
tackles | competitor - statistics | Integer | Number of tackles for a team in a match |
total_scrums | competitor - statistics | Integer | Number of total scrums for a team in a match |
tries | competitor - statistics | Integer | Number of tries for a team in a match |
try_assist | competitor - statistics | Integer | Number of try assists for a team in a match |
turnovers_won | competitor - statistics | Integer | Number of turnovers won for a team in a match |
yellow_cards | competitor - statistics | Integer | Number of yellow cards for a team in a match |
Venue:
Attribute | Parent Element | Type | Description |
---|---|---|---|
capacity | venue | Integer | Capacity of a venue ex. 25138 |
changed | venue | Boolean | Signifies a venue has been changed when true |
city_name | venue | String | City name of a venue ex. Wigan |
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:666 |
map_coordinates | venue | String | Coordinates of a venue ex. 53.547367,-2.654146 |
name | venue | String | Name of a venue ex. DW Stadium |
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 restrictued capacity |
timezone | venue | String | Timezone of a venue ex. Europe/London |