Match data

At the moment we have ball-by-ball information for 17,944 matches comprising 844 Test matches, 17 other multi-day matches, 2,858 One-day internationals, 450 other one-day matches, 3,856 T20 internationals, 320 international T20s, 0 Afghanistan Premier League matches, 576 Big Bash League matches, 17 T20 Blaze matches, 389 Bangladesh Premier League matches, 47 Bob Willis Trophy matches, 1,222 County Championship matches, 124 Charlotte Edwards Cup matches, 368 Caribbean Premier League matches, 314 CSA T20 Challenge matches, 39 FairBreak Invitational Tournament matches, 254 The Hundred matches, 66 International League T20 matches, 1,095 Indian Premier League matches, 72 Cricket Ireland Inter-Provincial Limited Over Cup matches, 82 Cricket Ireland Inter-Provincial Twenty20 Trophy matches, 119 Lanka Premier League matches, 42 Major League Cricket matches, 56 Mzansi Super League matches, 1,323 T20 Blast matches, 248 Plunket Shield matches, 280 Pakistan Super League matches, 189 Rachael Heyhoe Flint Trophy matches, 735 One-Day Cup matches, 66 SA20 matches, 8 Super 50 matches, 687 Syed Mushtaq Ali Trophy matches, 156 Sheffield Shield matches, 347 Super Smash matches, 458 Women's Big Bash League matches, 18 Women's Caribbean Premier League matches, 44 Women's Premier League matches, 95 Women's Cricket Super League matches, and 13 Women's T20 Challenge matches featuring 106 countries, 245 club teams, and 3 representative XIs going back as far as 2003 (for women), and 2001 (for men).

One thing that should be explained, as you may notice some mention of "withheld matches" on this page, is that 329 matches are currently being withheld from the data provided on the site. These matches either involve Afghanistan, or took place in the Afghanistan Premier League. A more complete explanation of why this restriction is in place can be found in the article that announced the change, "Explanation for withholding of Afghanistani matches".

The most recent matches added to the site are: the Ireland vs Bangladesh Women’s ODI match that was played on the 2nd of December, 2024, the Pakistan vs Zimbabwe Men’s T20 match that was played on the 1st of December, 2024, and the Melbourne Renegades vs Brisbane Heat Women's Big Bash League match that was played on the 1st of December, 2024.

The data format

The match data is provided in multiple different formats. The current formats are JSON, YAML, XML, and 2 versions in CSV. A detailed description of each format can be found in the Format section.

The data

The data is provided in number of zip files, one of which contains all of the matches, and the others certain sub-sets of matches, such as for type of matches, matches for certain countries, teams, or genders, or periods of time. We also provide (as an experiment) CSV, and XML versions of all matches. A sample is provided here, in both JSON and YAML formats, of some of the downloads available (specifically matches grouped by types of matches, and also domestic competitions, (for any gender), or you can see the full set of downloads, in various formats, on the downloads page.

All matches: 17,944 matches - JSON (83.7 MB), YAML (86.7 MB)
Test matches: 844 matches - JSON (10.1 MB), YAML (11.2 MB)
Multi-day matches: 1,714 matches - JSON (17.7 MB), YAML (20.5 MB)
One-day internationals: 2,858 matches - JSON (13.9 MB), YAML (14.1 MB)
One-day matches: 1,454 matches - JSON (6.8 MB), YAML (7.0 MB)
T20 internationals: 3,856 matches - JSON (12.2 MB), YAML (11.7 MB)
Non-official T20 internationals: 320 matches - JSON (993 KB), YAML (959 KB)
Afghanistan Premier League: 0 matches - JSON (1 KB), YAML (1 KB)
Bangladesh Premier League: 389 matches - JSON (1.3 MB), YAML (1.3 MB)
Big Bash League: 576 matches - JSON (1.9 MB), YAML (1.8 MB)
Bob Willis Trophy: 47 matches - JSON (447 KB), YAML (517 KB)
Caribbean Premier League: 368 matches - JSON (1.2 MB), YAML (1.2 MB)
Charlotte Edwards Cup: 124 matches - JSON (390 KB), YAML (381 KB)
County Championship: 1,222 matches - JSON (12.5 MB), YAML (14.4 MB)
Cricket Ireland Inter-Provincial Limited Over Cup: 72 matches - JSON (326 KB), YAML (342 KB)
Cricket Ireland Inter-Provincial Twenty20 Trophy: 82 matches - JSON (252 KB), YAML (250 KB)
CSA T20 Challenge: 314 matches - JSON (989 KB), YAML (969 KB)
FairBreak Invitational Tournament: 39 matches - JSON (124 KB), YAML (121 KB)
Indian Premier League: 1,095 matches - JSON (3.6 MB), YAML (3.4 MB)
International League T20: 66 matches - JSON (224 KB), YAML (210 KB)
Lanka Premier League: 119 matches - JSON (400 KB), YAML (375 KB)
Major League Cricket: 42 matches - JSON (140 KB), YAML (132 KB)
Mzansi Super League: 56 matches - JSON (179 KB), YAML (174 KB)
One-Day Cup: 735 matches - JSON (3.5 MB), YAML (3.6 MB)
Pakistan Super League: 280 matches - JSON (938 KB), YAML (885 KB)
Plunket Shield: 248 matches - JSON (2.7 MB), YAML (3.1 MB)
Rachael Heyhoe Flint Trophy: 189 matches - JSON (894 KB), YAML (939 KB)
SA20: 66 matches - JSON (214 KB), YAML (201 KB)
Sheffield Shield: 156 matches - JSON (1.7 MB), YAML (2.0 MB)
Super 50: 8 matches - JSON (29 KB), YAML (30 KB)
Super Smash: 347 matches - JSON (1.1 MB), YAML (1.1 MB)
Syed Mushtaq Ali Trophy: 687 matches - JSON (2.1 MB), YAML (2.0 MB)
T20 Blast: 1,323 matches - JSON (4.1 MB), YAML (4.0 MB)
T20 Blaze: 17 matches - JSON (50 KB), YAML (49 KB)
The Hundred: 254 matches - JSON (769 KB), YAML (721 KB)
Women's Big Bash League: 458 matches - JSON (1.4 MB), YAML (1.4 MB)
Women's Caribbean Premier League: 18 matches - JSON (59 KB), YAML (56 KB)
Women's Cricket Super League: 95 matches - JSON (293 KB), YAML (286 KB)
Women's Premier League: 44 matches - JSON (144 KB), YAML (137 KB)
Women's T20 Challenge: 13 matches - JSON (43 KB), YAML (41 KB)

Using the data

What could you do with the data? Well that’s up to you really. You could investigate who are the best and worst value players in the IPL. Or see how much difference different non-strikers make to the scoring rate of the people they bat with. Or come up with something completely new that revolutionises cricket like finding the equivalent of DIPS (Defense independent pitching statistics) from baseball.