Find all updates to the Cricket v2 API and its documentation
Venue State
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 09/06/2024 | Daily Live Schedule Daily Results Daily Schedule Match Lineups Match Summary Match Timeline Match Timeline Delta Team Results Team Schedule Team vs Team Tournament Results Tournament Schedule | Added states to venues where applicable. ex. state="TX" (Texas) |
<sport_event id="sr:match:48876457" scheduled="2024-04-13T15:00:00+00:00" start_time_tbd="false" status="closed">
<tournament_round type="group" number="1"/>
<season id="sr:season:116943" name="T20 Series USA vs Canada 2024" start_date="2024-04-07" end_date="2024-04-14" year="2024"/>
<tournament id="sr:tournament:42487" name="T20 Series USA vs Canada" type="t20i" gender="men">
<sport id="sr:sport:21" name="Cricket"/>
<category id="sr:category:105" name="International"/>
</tournament>
<competitors>
<team id="sr:competitor:215842" name="USA" country="USA" country_code="USA" abbreviation="USA" qualifier="home" gender="male"/>
<team id="sr:competitor:142694" name="Canada" country="Canada" country_code="CAN" abbreviation="CAN" qualifier="away" gender="male"/>
</competitors>
<venue id="sr:venue:63681" name="Prairie View Cricket Complex" city_name="Prairie View" country_name="USA" map_coordinates="30.086723, -96.004477" country_code="USA" timezone="America/Chicago" state="TX"/>
</sport_event>
{
"id": "sr:match:48876457",
"tournament_round": {
"type": "group",
"number": 1
},
"season": {
"id": "sr:season:116943",
"name": "T20 Series USA vs Canada 2024",
"start_date": "2024-04-07",
"end_date": "2024-04-14",
"year": "2024"
},
"scheduled": "2024-04-13T15:00:00+00:00",
"start_time_tbd": false,
"tournament": {
"id": "sr:tournament:42487",
"name": "T20 Series USA vs Canada",
"type": "t20i",
"gender": "men",
"sport": {
"id": "sr:sport:21",
"name": "Cricket"
},
"category": {
"id": "sr:category:105",
"name": "International"
}
},
"status": "closed",
"competitors": [
{
"id": "sr:competitor:215842",
"name": "USA",
"country": "USA",
"country_code": "USA",
"abbreviation": "USA",
"qualifier": "home",
"gender": "male"
},
{
"id": "sr:competitor:142694",
"name": "Canada",
"country": "Canada",
"country_code": "CAN",
"abbreviation": "CAN",
"qualifier": "away",
"gender": "male"
}
],
"venue": {
"id": "sr:venue:63681",
"name": "Prairie View Cricket Complex",
"city_name": "Prairie View",
"country_name": "USA",
"map_coordinates": "30.086723, -96.004477",
"country_code": "USA",
"timezone": "America/Chicago",
"state": "TX"
}
}
Display Overs per Period
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 07/02/2024 | Daily Results Match Summary Match Timeline Team Results Team vs Team Tournament Results | We have added display_overs into period_scores for matches.This will ensure you can retrieve the amount of overs a team batted for within all periods. |
<sport_event_status match_status="ended" status="closed" display_score="137/2" winner_id="sr:competitor:242120" toss_won_by="sr:competitor:242120" toss_decision="bowl" current_inning="2" display_overs="28.3" target="102" remaining_overs="-0.3" run_rate="4.81" allotted_overs="50">
<period_scores>
<period_score home_score="230" away_score="0" type="inning" number="1" allotted_overs="50"
display_overs="49.2" home_wickets="10" display_score="230/10"/>
<period_score home_score="0" away_score="137" type="inning" number="2" allotted_overs="50"
display_overs="28.3" away_wickets="2" display_score="137/2"/>
</period_scores>
</sport_event_status>
Player Info
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 04/10/2024 | Tournament Squads | Added the following player data points to the Tournament Squads endpoint: - Date of Birth - Nationality - Role/Position |
<tournament_team_squads xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2024-04-10T10:17:14+00:00" xmlns="http://schemas.sportradar.com/sportsapi/cricket/v2" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/cricket/v2 https://schemas.sportradar.com/sportsapi/cricket/v2/schemas/tournament_team_squads.xsd">
<team id="sr:competitor:152318" name="Royal Challengers Bengaluru" country="India" country_code="IND" abbreviation="RCB" gender="male"/>
<manager id="sr:player:647880" name="Bangar, Sanjay" date_of_birth="1972-10-11" nationality="India" country_code="IND"/>
<players>
<player id="sr:player:638248" name="Singh, Swapnil" date_of_birth="1991-01-22" country_code="IND" nationality="India" type="all_rounder"/>
<player id="sr:player:643154" name="Kohli, Virat" date_of_birth="1988-11-05" country_code="IND" nationality="India" type="batsman"/>
<player id="sr:player:655834" name="Karthik, Dinesh" date_of_birth="1985-06-01" country_code="IND" nationality="India" type="wicket_keeper"/>
<player id="sr:player:656636" name="Sharma, Karn" date_of_birth="1987-10-23" country_code="IND" nationality="India" type="bowler"/>
<player id="sr:player:663378" name="Maxwell, Glenn" date_of_birth="1988-10-14" country_code="AUS" nationality="Australia" type="all_rounder"/>
<player id="sr:player:699754" name="du Plessis, Faf" date_of_birth="1984-07-13" country_code="ZAF" nationality="South africa" type="batsman"/>
<player id="sr:player:703432" name="Topley, Reece" date_of_birth="1994-02-21" country_code="ENG" nationality="England" type="bowler"/>
<player id="sr:player:713202" name="Ferguson, Lockie" date_of_birth="1991-06-13" country_code="NZL" nationality="New zealand" type="bowler"/>
<player id="sr:player:728962" name="Curran, Tom" date_of_birth="1995-03-12" country_code="ENG" nationality="England" type="all_rounder"/>
<player id="sr:player:741580" name="Joseph, Alzarri" date_of_birth="1996-11-20" country_code="ATG" nationality="Antigua and barbuda" type="bowler"/>
<player id="sr:player:748522" name="Kumar, Vyshak" date_of_birth="1997-01-31" country_code="IND" nationality="India" type="bowler"/>
<player id="sr:player:980915" name="Lomror, Mahipal" date_of_birth="1999-11-16" country_code="IND" nationality="India" type="all_rounder"/>
<player id="sr:player:1097578" name="Jacks, Will" date_of_birth="1998-11-21" country_code="ENG" nationality="England" type="batsman"/>
<player id="sr:player:1104247" name="Siraj, Mohammed" date_of_birth="1994-03-13" country_code="IND" nationality="India" type="bowler"/>
<player id="sr:player:1279018" name="Bhandage, Manoj" date_of_birth="1998-10-05" country_code="IND" nationality="India" type="all_rounder"/>
<player id="sr:player:1283622" name="Dagar, Mayank" date_of_birth="1996-11-11" country_code="IND" nationality="India" type="all_rounder"/>
<player id="sr:player:1322738" name="Patidar, Rajat" date_of_birth="1993-06-01" country_code="IND" nationality="India" type="batsman"/>
<player id="sr:player:1325934" name="Rawat, Anuj" date_of_birth="1999-10-17" country_code="IND" nationality="India" type="wicket_keeper"/>
<player id="sr:player:1374295" name="Green, Cameron" date_of_birth="1999-06-03" country_code="AUS" nationality="Australia" type="all_rounder"/>
<player id="sr:player:1602994" name="Prabhudessai, Suyash" date_of_birth="1997-12-06" country_code="IND" nationality="India" type="batsman"/>
<player id="sr:player:1603338" name="Dayal, Yash" date_of_birth="1997-12-13" country_code="IND" nationality="India" type="bowler"/>
<player id="sr:player:1717659" name="Deep, Akash" date_of_birth="1996-12-15" country_code="IND" nationality="India" type="bowler"/>
<player id="sr:player:2250811" name="Chauhan, Saurav Dilipsingh" date_of_birth="2000-05-27" country_code="IND" nationality="India" type="batsman"/>
<player id="sr:player:2467757" name="Kumar, Rajan" date_of_birth="1996-07-08" country_code="IND" nationality="India" type="bowler"/>
<player id="sr:player:2530447" name="Sharma, Himanshu" date_of_birth="1998-06-06" country_code="IND" nationality="India" type="bowler"/>
</players>
</tournament_team_squads>
{
"generated_at": "2024-04-10T14:28:46+00:00",
"team": {
"id": "sr:competitor:152318",
"name": "Royal Challengers Bengaluru",
"country": "India",
"country_code": "IND",
"abbreviation": "RCB",
"gender": "male"
},
"manager": {
"id": "sr:player:647880",
"name": "Bangar, Sanjay",
"date_of_birth": "1972-10-11",
"nationality": "India",
"country_code": "IND"
},
"players": [
{
"id": "sr:player:638248",
"name": "Singh, Swapnil",
"date_of_birth": "1991-01-22",
"country_code": "IND",
"nationality": "India",
"type": "all_rounder"
},
{
"id": "sr:player:643154",
"name": "Kohli, Virat",
"date_of_birth": "1988-11-05",
"country_code": "IND",
"nationality": "India",
"type": "batsman"
},
{
"id": "sr:player:655834",
"name": "Karthik, Dinesh",
"date_of_birth": "1985-06-01",
"country_code": "IND",
"nationality": "India",
"type": "wicket_keeper"
},
{
"id": "sr:player:656636",
"name": "Sharma, Karn",
"date_of_birth": "1987-10-23",
"country_code": "IND",
"nationality": "India",
"type": "bowler"
},
{
"id": "sr:player:663378",
"name": "Maxwell, Glenn",
"date_of_birth": "1988-10-14",
"country_code": "AUS",
"nationality": "Australia",
"type": "all_rounder"
},
{
"id": "sr:player:699754",
"name": "du Plessis, Faf",
"date_of_birth": "1984-07-13",
"country_code": "ZAF",
"nationality": "South africa",
"type": "batsman"
},
{
"id": "sr:player:703432",
"name": "Topley, Reece",
"date_of_birth": "1994-02-21",
"country_code": "ENG",
"nationality": "England",
"type": "bowler"
},
{
"id": "sr:player:713202",
"name": "Ferguson, Lockie",
"date_of_birth": "1991-06-13",
"country_code": "NZL",
"nationality": "New zealand",
"type": "bowler"
},
{
"id": "sr:player:728962",
"name": "Curran, Tom",
"date_of_birth": "1995-03-12",
"country_code": "ENG",
"nationality": "England",
"type": "all_rounder"
},
{
"id": "sr:player:741580",
"name": "Joseph, Alzarri",
"date_of_birth": "1996-11-20",
"country_code": "ATG",
"nationality": "Antigua and barbuda",
"type": "bowler"
},
{
"id": "sr:player:748522",
"name": "Kumar, Vyshak",
"date_of_birth": "1997-01-31",
"country_code": "IND",
"nationality": "India",
"type": "bowler"
},
{
"id": "sr:player:980915",
"name": "Lomror, Mahipal",
"date_of_birth": "1999-11-16",
"country_code": "IND",
"nationality": "India",
"type": "all_rounder"
},
{
"id": "sr:player:1097578",
"name": "Jacks, Will",
"date_of_birth": "1998-11-21",
"country_code": "ENG",
"nationality": "England",
"type": "batsman"
},
{
"id": "sr:player:1104247",
"name": "Siraj, Mohammed",
"date_of_birth": "1994-03-13",
"country_code": "IND",
"nationality": "India",
"type": "bowler"
},
{
"id": "sr:player:1279018",
"name": "Bhandage, Manoj",
"date_of_birth": "1998-10-05",
"country_code": "IND",
"nationality": "India",
"type": "all_rounder"
},
{
"id": "sr:player:1283622",
"name": "Dagar, Mayank",
"date_of_birth": "1996-11-11",
"country_code": "IND",
"nationality": "India",
"type": "all_rounder"
},
{
"id": "sr:player:1322738",
"name": "Patidar, Rajat",
"date_of_birth": "1993-06-01",
"country_code": "IND",
"nationality": "India",
"type": "batsman"
},
{
"id": "sr:player:1325934",
"name": "Rawat, Anuj",
"date_of_birth": "1999-10-17",
"country_code": "IND",
"nationality": "India",
"type": "wicket_keeper"
},
{
"id": "sr:player:1374295",
"name": "Green, Cameron",
"date_of_birth": "1999-06-03",
"country_code": "AUS",
"nationality": "Australia",
"type": "all_rounder"
},
{
"id": "sr:player:1602994",
"name": "Prabhudessai, Suyash",
"date_of_birth": "1997-12-06",
"country_code": "IND",
"nationality": "India",
"type": "batsman"
},
{
"id": "sr:player:1603338",
"name": "Dayal, Yash",
"date_of_birth": "1997-12-13",
"country_code": "IND",
"nationality": "India",
"type": "bowler"
},
{
"id": "sr:player:1717659",
"name": "Deep, Akash",
"date_of_birth": "1996-12-15",
"country_code": "IND",
"nationality": "India",
"type": "bowler"
},
{
"id": "sr:player:2250811",
"name": "Chauhan, Saurav Dilipsingh",
"date_of_birth": "2000-05-27",
"country_code": "IND",
"nationality": "India",
"type": "batsman"
},
{
"id": "sr:player:2467757",
"name": "Kumar, Rajan",
"date_of_birth": "1996-07-08",
"country_code": "IND",
"nationality": "India",
"type": "bowler"
},
{
"id": "sr:player:2530447",
"name": "Sharma, Himanshu",
"date_of_birth": "1998-06-06",
"country_code": "IND",
"nationality": "India",
"type": "bowler"
}
]
}
Tournament Squads Endpoint
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 11/13/2023 | Tournament Squads | Added a Tournament Squads endpoint. This endpoint provides squad lineups for a given tournament or season. |
Allotted Overs
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/30/2023 | Match Summary Match Timeline Match Timeline Delta | Added the number of allotted overs for a match at the period (period_score.allotted_overs) and match (sport_event_status.allotted_overs) level. |
<sport_event_status match_status="ended" status="closed" display_score="286/10" winner_id="sr:competitor:142690" toss_won_by="sr:competitor:142690" toss_decision="bat" current_inning="2" display_overs="49.4" required_run_rate="201" run_rate="5.76" allotted_overs="50">
<period_scores>
<period_score home_score="0" away_score="352" type="inning" number="1" allotted_overs="50" away_wickets="7" display_score="352/7"/>
<period_score home_score="286" away_score="0" type="inning" number="2" allotted_overs="50" home_wickets="10" display_score="286/10"/>
</period_scores>
</sport_event_status>
"sport_event_status": {
"match_status": "ended",
"status": "closed",
"display_score": "286/10",
"winner_id": "sr:competitor:142690",
"toss_won_by": "sr:competitor:142690",
"toss_decision": "bat",
"current_inning": 2,
"display_overs": 49.4,
"required_run_rate": 201,
"run_rate": 5.76,
"allotted_overs": 50,
"period_scores": [
{
"home_score": 0,
"away_score": 352,
"type": "inning",
"number": 1,
"allotted_overs": 50,
"away_wickets": 7,
"display_score": "352/7"
},
{
"home_score": 286,
"away_score": 0,
"type": "inning",
"number": 2,
"allotted_overs": 50,
"home_wickets": 10,
"display_score": "286/10"
}
]
},
Tournament Leaders Endpoint
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/30/2023 | Tournament Leaders | Added a Tournament Leaders endpoint. This endpoint provides leaders in a given tournament or season for a variety of stats including top runs, top average, top wickets, top bowling average, top economy, and top catches. |
Required Run Rate
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/18/2023 | Daily Results Match Summary Match Timeline Match Timeline Delta Team Results Team vs Team Tournament Results | Added required run rate (sport_event_status.required_run_rate) to match statistics. |
<result>
<sport_event id="sr:match:44023764" scheduled="2023-10-17T03:30:00+00:00" start_time_tbd="false">
<tournament_round type="group" number="1"/>
<season id="sr:season:111084" name="Syed Mushtaq Ali Trophy 2023" start_date="2023-10-16" end_date="2023-11-06" year="2023"/>
</sport_event>
<sport_event_status match_status="ended" status="closed" display_score="160/2" winner_id="sr:competitor:393218" toss_won_by="sr:competitor:393230" toss_decision="bat" current_inning="2" display_overs="18.3" required_run_rate="0">
<period_scores>
<period_score home_score="0" away_score="159" type="inning" number="1" away_wickets="8" display_score="159/8"/>
<period_score home_score="160" away_score="0" type="inning" number="2" home_wickets="2" display_score="160/2"/>
</period_scores>
</sport_event_status>
</result>
"results": [
{
"sport_event": {
"id": "sr:match:44023764",
"tournament_round": {
"type": "group",
"number": 1
},
"season": {
"id": "sr:season:111084",
"name": "Syed Mushtaq Ali Trophy 2023",
"start_date": "2023-10-16",
"end_date": "2023-11-06",
"year": "2023"
},
"scheduled": "2023-10-17T03:30:00+00:00",
"start_time_tbd": false
},
"sport_event_status": {
"match_status": "ended",
"status": "closed",
"display_score": "160/2",
"toss_won_by": "sr:competitor:393230",
"toss_decision": "bat",
"current_inning": 2,
"winner_id": "sr:competitor:393218",
"display_overs": 18.3,
"required_run_rate": 0,
"period_scores": [
{
"home_score": 0,
"away_score": 159,
"type": "inning",
"number": 1,
"away_wickets": 8,
"display_score": "159/8"
},
{
"home_score": 160,
"away_score": 0,
"type": "inning",
"number": 2,
"home_wickets": 2,
"display_score": "160/2"
}
]
}
},
Match Timeline Delta Endpoint
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 10/06/2023 | Match Timeline Delta | Added the Match Timeline Delta endpoint for parity with the Cricket Legacy v2 API. During a live match, the timeline delta provides all the same data as the match timeline feed, but in 5-minute increments. |
UPGRADE - New Data Source
| Release Date | Benefit |
|---|---|
| 09/28/2023 | We have upgraded our data source that powers the Cricket v2 API. Following this upgrade, the data within our Cricket v2 API is official for ICC, ECB and Caribbean Premier League. Our Cricket Content Strategy document details which competitions will be covered by our official data. The new dataset will also include each of the below features: - Custom-designed for cricket with multi-mode capability to ensure the lowest latency in the market. - Unique fielding data points exclusive to Sportradar - Ball tracking for shot and delivery, type coding and AI-powered automated text commentary. - Automated system monitoring platform redundancy to ensure reliable, uninterrupted service.While we mapped out our new data to our existing attributes, there are some attributes that we will not be replacing. Details of this can be found in the Cricket Data Points Mapping document.Additionally, commentary will now be computer generated. Please see some examples below from a single over: - Back of a length from Boult, pitching outside off stump. Gaikwad moves onto the back foot and punches a drive on the off side for a single run. Quality work in the field by Neesham prevents a certain boundary. - FOUR! Full, on a good line. Du Plessis gets on the front foot and drives straight down the ground for four runs. - OUT! Caught. Boult drops one in short, pitching outside off. Du Plessis moves onto the back foot and edges and is caught by Pandya. - On a good length, outside off stump once again. Ali gets forward and plays a defensive stroke through the off side. The throw by de Kock is terrific. Mumbai Indians appeal for a run-out, and it’s referred to the third umpire for review. The replay shows the batter made it in safely. - SIX! Dropped in short by Boult, pitching outside leg and angling across. Ali rocks back, and hooks for a half dozen runs behind square. - Pitching on a good line and length. Ali moves onto the back foot and is hit on the pads while attempting to play a defensive stroke. Mumbai Indians appeal for LBW, however, umpire Ananthapadmanabhan gives Ali not out. Mumbai Indians call for a review. DRS comes back as an umpire’s call, and Ali is not out. |
Neutral Site Support
| Release Date | Feeds Affected | Benefit |
| 06/30/2022 | Match Summary Match Timeline | New attribute displays whether a match is played at a neutral venue or not. |
Zero-Based Period Scores
| Release Date | Feeds Affected | Benefit |
| 05/23/2022 | Match Summary Match Timeline | Updated the match endpoints to display zero-based period scores as soon as a match begins, and prior to the first run. |
Live Coverage Indicator
| Release Date | Feeds Affected | Benefit |
| 06/04/2019 | Match Timeline | Added live coverage data point and coverage level. Updated the Coverage Information to better describe match coverage. |
Tournament Squads Endpoint
| Release Date | Feeds Affected | Benefit |
| 10/04/2018 | Tournament Squads | Added Tournament Squads feed. |
Substitutes and Dismissals
| Release Date | Feeds Affected | Benefit |
| 09/18/2018 | Match Timeline | Added is_substitute_fielder to the dismissal_details element in the Match Timeline feed. |
Standings Update
| Release Date | Feeds Affected | Benefit |
| 08/16/2018 | Tournament Standings | Added team_standing – change and team_standing – current_outcome to the standings feeds. |
Retired (Hurt) to Player Batting
| Release Date | Feeds Affected | Benefit |
| 11/13/2017 | Match Summary Match Timeline | Added data point for retired_hurt under player batting statistics. |
Captain and Wicket-Keeper Designation
| Release Date | Feeds Affected | Benefit |
| 04/21/2017 | Match Lineups | Added is_captain and is_wicketkeeper data points for players. |
API Release
| Release Date | Feeds Affected | Benefit |
| 04/10/2017 | All | Initial release of Cricket v2. |