Cricket ball-by-ball data
Every delivery of 23,241 matches: Tests, ODIs, T20Is and the T20 leagues, men's and women's, with batter, bowler, runs, extras, wickets and fielders.
YorkerAPI serves ball-by-ball records for Tests, ODIs and T20 internationals, the IPL, the Big Bash, the PSL, the CPL, the T20 Blast, The Hundred, the County Championship and more, men's and women's. Each ball has the batter, the bowler, the runs, the extras, any wicket with its fielders, and the score after it.
Limited-overs balls also carry our model's chance the batting side wins. Ask for every ball of a match, or every ball a batter faced or a bowler bowled in a competition, with get_deliveries. Batting and bowling figures across the API are counted from these balls. The table below is read from the database.
Coverage by season
Counted from the database on November 12, 2026.
| Season | Matches | Balls |
|---|---|---|
| 2026 | 2,294 | 939,013 |
| 2025 | 2,546 | 1,108,896 |
| 2024 | 2,441 | 983,269 |
| 2023 | 2,009 | 861,956 |
| 2022 | 2,012 | 921,156 |
| 2021 | 1,640 | 749,338 |
| 2020 | 728 | 344,107 |
| 2019 | 1,652 | 727,273 |
| 2018 | 1,310 | 653,703 |
| 2017 | 1,075 | 631,963 |
| 2016 | 1,032 | 639,939 |
| 2015 | 883 | 589,676 |
| 2014 | 863 | 568,588 |
| 2013 | 526 | 278,267 |
| 2012 | 431 | 229,461 |
| 2011 | 292 | 181,910 |
| 2010 | 288 | 177,733 |
| 2009 | 271 | 174,292 |
| 2008 | 221 | 154,799 |
| 2007 | 222 | 147,879 |
| 2006 | 168 | 146,754 |
| 2005 | 95 | 79,281 |
| 2004 | 96 | 74,909 |
| 2003 | 140 | 104,009 |
How to get it
get_deliveries, 10 credits a call. A full 2026 season is 2,294 calls and 22,940 credits, which fits in one month of Pro ($49/mo).
curl -X POST https://mcp.yorkerapi.com/v1/get_deliveries \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"match_id": "1473511",
"innings": 2
}'What comes back
| deliveries[] | List of objects |
| deliveries[].match_id | |
| deliveries[].date | |
| deliveries[].innings | |
| deliveries[].over | |
| deliveries[].ball | |
| deliveries[].delivery | |
| deliveries[].legal | |
| deliveries[].batter_id | |
| deliveries[].batter | |
| deliveries[].bowler_id | |
| deliveries[].bowler | |
| deliveries[].non_striker_id | |
| deliveries[].runs_batter |
Every field and a real response: get_deliveries docs.
Questions
How far back does the ball-by-ball go?
The first match is from December 2001. Coverage is thin until 2003, and the record is deepest from about 2010. The table shows every calendar year with at least 50 matches.
Does it include women's cricket?
Yes: 4,714 women's matches, including T20Is, ODIs, Tests, the WBBL, the WPL and The Hundred. Women's sides have their own team ids, such as india-women.
Does it have where the ball pitched or was hit?
No. There are no line, length or wagon-wheel coordinates, only what happened on each ball.
Can I use it from Claude or ChatGPT?
Yes. YorkerAPI is an MCP server as well as a REST API: add one URL to Claude, Cursor or any MCP client and ask in plain English.
What it will not do
- No pitch maps or shot locations.
- Not every domestic competition is held, and older domestic seasons are partial.
- Balls land after a match ends, usually within a day; it is not a live feed.
- Win probability covers limited-overs matches only, not Tests or first-class cricket.
Works with
Start with 500 free credits every month
No card. REST or MCP.