Docs
Coverage MatrixDocumentationRelease LogLog In

Find all updates to the Cricket v2 API and its documentation

Player Info

Release DateFeeds AffectedBenefit
04/10/2024Tournament
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 DateFeeds AffectedBenefit
11/13/2023Tournament
Squads
Added a Tournament Squads endpoint.

This endpoint provides squad lineups for a given tournament or season.


Allotted Overs

Release DateFeeds AffectedBenefit
10/30/2023Match 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 DateFeeds AffectedBenefit
10/30/2023Tournament
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 DateFeeds AffectedBenefit
10/18/2023Daily 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 DateFeeds AffectedBenefit
10/06/2023Match Timeline DeltaAdded 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 DateBenefit
09/28/2023We 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 DateFeeds AffectedBenefit
06/30/2022Match Summary
Match Timeline
New attribute displays whether a match is played at a neutral venue or not.

Zero-Based Period Scores

Release DateFeeds AffectedBenefit
05/23/2022Match 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 DateFeeds AffectedBenefit
06/04/2019Match TimelineAdded live coverage data point and coverage level. Updated the Coverage Information to better describe match coverage.

Tournament Squads Endpoint

Release DateFeeds AffectedBenefit
10/04/2018Tournament SquadsAdded Tournament Squads feed.

Substitutes and Dismissals

Release DateFeeds AffectedBenefit
09/18/2018Match TimelineAdded is_substitute_fielder to the dismissal_details element in the Match Timeline feed.

Standings Update

Release DateFeeds AffectedBenefit
08/16/2018Tournament StandingsAdded team_standing – change and team_standing – current_outcome to the standings feeds.

Retired (Hurt) to Player Batting

Release DateFeeds AffectedBenefit
11/13/2017Match Summary
Match Timeline
Added data point for retired_hurt under player batting statistics.

Captain and Wicket-Keeper Designation

Release DateFeeds AffectedBenefit
04/21/2017Match LineupsAdded is_captain and is_wicketkeeper data points for players.

API Release

Release DateFeeds AffectedBenefit
04/10/2017AllInitial release of Cricket v2.