Team Versus Team

get

https://api.sportradar.com/cricket-{access_level}2/{language_code}/teams/{team_id}/versus/{team_id2}/matches.{format}

Provides previous and upcoming meetings between two teams including results.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
30s Time To Live / Cache

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event` - `tournament` - `category`	String	Country code for a tournament's category
`id`	`sport_event` - `tournament` - `category`	String	Unique category ID for a tournament ex. `sr:category:105`
`name`	`sport_event` - `tournament` - `category`	String	Name for a tournament's category ex. `International`
`id`	`sport_event` - `tournament` - `sport`	String	Unique sport ID for a tournament ex. `sr:sport:21`
`name`	`sport_event` - `tournament` - `sport`	String	Name for a tournament's sport ex. `Cricket`

Season

Attribute	Parent Element	Type	Description
`end_date`	`sport_event` - `season`	Date	End date of a sport event's season ex. `2024-06-17`
`id`	`sport_event` - `season`	String	Unique ID for a sport event's season ex. `sr:season:122977` (Sheffield Shield 24/25)
`name`	`sport_event` - `season`	String	Name of a sport event's season ex. `Sheffield Shield 24/25`
`start_date`	`sport_event` - `season`	Date	Start date of a sport event's season ex. `2023-09-23`
`tournament_id`	`sport_event` - `season`	String	Unique tournament ID for a sport event's season ex. `sr:tournament:21568` (Sheffield Shield)
`year`	`sport_event` - `season`	String	Year of a sport event's season ex. `23/24` or `2024`

Tournament

Attribute	Parent Element	Type	Description
`gender`	`sport_event` - `tournament`	String	Gender of a sport event's tournament `men`, `women`, `mixed`
`id`	`sport_event` - `tournament`	String	Unique ID for a sport event's tournament ex. `sr:tournament:21568` (Sheffield Shield)
`name`	`sport_event` - `tournament`	String	Name of a sport event's tournament ex. `Sheffield Shield`
`type`	`sport_event` - `tournament`	String	Type of a sport event's tournament `test`, `odi`, `t10`, `t20i`, `first_class`, `list_a`, `t20`, `the_hundred`
`name`	`sport_event` - `tournament_round`	String	Name of a sport event's tournament round
`number`	`sport_event` - `tournament_round`	Integer	Number of a sport event's tournament round
`type`	`sport_event` - `tournament_round`	String	Type of a sport event's tournament round ex. `group`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `team`	String	Abbreviation for a competitor name ex. `BUL` (Queensland Bulls)
`country`	`competitors` - `team`	String	Country of a competitor ex. `Australia`
`country_code`	`competitors` - `team`	String	Country code of a competitor ex. `AUS` (Australia)
`gender`	`competitors` - `team`	String	Gender for a competitor `male`, `female`
`id`	`competitors` - `team`	String	Unique ID for a competitor ex. `sr:competitor:142678` (Queensland Bulls)
`name`	`competitors` - `team`	String	Name for a competitor ex. `Queensland Bulls`
`qualifier`	`competitors` - `team`	String	Designation of a competitor for a sport event `home`, `away`
`virtual`	`competitors` - `team`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:52962997`
`scheduled`	`sport_event`	Date-time	Scheduled start time of a match ex. `2025-02-08T00:00:00+00:00`
`start_time_tbd`	`sport_event`	Boolean	Signifies the start time of a match is TBD when `true`
`status`	`sport_event`	String	Status of a match. See our FAQ for a complete list of statuses and their definitions

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team inning score
`allotted_overs`	`sport_event_status` - `period_scores` - `period_score`	Integer	Number of allotted overs for an inning
`away_wickets`	`sport_event_status` - `period_scores` - `period_score`	Integer	Number of away wickets in an inning
`display_overs`	`sport_event_status` - `period_scores` - `period_score`	Float	Number of overs for an inning ex. `33.3`
`display_score`	`sport_event_status` - `period_scores` - `period_score`	String	Display score for an inning ex. `144/10`
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team inning score
`home_wickets`	`sport_event_status` - `period_scores` - `period_score`	Integer	Number of home wickets in an inning
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Inning number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `inning`

Sport Event Status

Attribute	Parent Element	Type	Description
`allotted_overs`	`sport_event_status`	Integer	Number of allotted overs for the current inning
`current_inning`	`sport_event_status`	Integer	Current inning of a match
`current_session`	`sport_event_status`	Integer	Current session of a match
`display_overs`	`sport_event_status`	Float	Number of overs for the current inning ex. `33.3`
`display_score`	`sport_event_status`	String	Display score for the current inning ex. `144/10`
`match_result_text`	`sport_event_status`	String	Text description of the result of a match ex. `Oval Invincibles won by 6 wickets` or `London Spirit won by 17 runs`
`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. `first_innings_away`, `stumps`, `ended`, `tea_break` See our FAQ for a complete list of statuses
`required_run_rate`	`sport_event_status`	Float	The run rate the batting side must achieve in order to win a match ex. `20.222`
`run_rate`	`sport_event_status`	Float	Current run rate of the batting side ex. `4.3`
`status`	`sport_event_status`	String	Status of a match ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions
`toss_decision`	`sport_event_status`	String	Decision of the team winning the toss ex. `bat`, `bowl`
`toss_won_by`	`sport_event_status`	String	Unique ID of the team which won the toss ex. `sr:competitor:142710`
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:142704`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `22500`
`city_id`	`venue`	String	Unique ID of a city ex. `sr:city:59`
`city_name`	`venue`	String	City name of a venue ex. `Sylhet`
`country_code`	`venue`	String	Country code of a venue ex. `BGD` (Bangladesh)
`country_name`	`venue`	String	Country name of a venue ex. `Bangladesh`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:24744`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `24.920781,91.868653`
`name`	`venue`	String	Name of a venue ex. `Sylhet International Cricket Stadium`
`timezone`	`venue`	String	Timezone of a venue ex. `Asia/Kolkata`
`state`	`venue`	String	State of a venue ex. `Sylhet International Cricket Stadium`
`name`	`venue` - `bowling_end`	String	Name of a venue bowling end ex. `Anna Pavilion End`, `V Pattabhiraman Gate End`

Response

Language

Credentials

Query

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json