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.