The open cricket API, ball by ball.Ready for your apps and AI agents.

A cricket data API built for developers and AI agents: scorecards, every delivery, partnerships and player matchups across Tests, ODIs, T20Is and the major T20 leagues.

Join the waitlist Explore the API

Free Starter plan · No credit card · Keys open to the waitlist first

23kmatches

11.6Mdeliveries

12MCP tools

Developer using a laptop beside a cricket bat and ball, with connected cricket ground, worm and Manhattan chart panels

Deterministic IDs

Named open-data source

Every delivery since 2001

Predictable monthly quotas

GET/v1/matches/{id}/deliveries200

GLOBAL CATALOG

109 cricket nations. Every ball you can query.

From India, England and Australia to Nepal, Namibia and Rwanda. Tests, ODIs, T20Is, ICC events and 49 club competitions, each with an explicit source and licence.

Explore coverage

[ CRICKET NATIONS ]DRAG TO EXPLORE

EMBEDDABLE WIDGETS · AT LAUNCH

Three widgets. One data contract.Paste OpenCricket into any site.

Results boards, scorecards and match intelligence with deterministic IDs, named source provenance and explicit unavailable states. The previews below render real finals.

REST auto-refresh Over-by-over and phase splits Zero synthetic data Every format, one schema

Get widgets at launch Inspect a full match

opencricketapi.com/embed/results

UI PREVIEW · REAL RESULTS

RECENT FINALSBY DATE ↓

source: cricsheet

FINALKohli 75

GTGujarat Titans155/8

RCBRoyal Challengers Bengaluru161/5

Indian Premier League

Royal Challengers Bengaluru won by 5 wickets

FINALSamson 89

INDIndia255/5

NZNew Zealand159

ICC Men's T20 World Cup

India won by 96 runs

FINALSeifert 72

TRRTrent Rockets158/8

MSGManchester Super Giants162/5

The Hundred Men's Competition

Manchester Super Giants won by 5 wickets

FINALPienaar 53

LAKRLos Angeles Knight Riders164

WFWashington Freedom163/9

Major League Cricket

Los Angeles Knight Riders won by 1 run

FINALHardie 56

HYKHyderabad Kingsmen129

PZPeshawar Zalmi130/5

Pakistan Super League

Peshawar Zalmi won by 5 wickets

FINALVarma 69

PAKPakistan146

INDIndia150/5

Men's T20 Asia Cup

India won by 5 wickets

FINALBrevis 101

PCPretoria Capitals158/7

SECSunrisers Eastern Cape162/4

SA20

Sunrisers Eastern Cape won by 6 wickets

FINALMarsh 44

SIXSydney Sixers132

SCOPerth Scorchers133/4

Big Bash League

Perth Scorchers won by 6 wickets

FINALAhmed 30

GAWGuyana Amazon Warriors130/8

TKRTrinbago Knight Riders133/7

Caribbean Premier League

Trinbago Knight Riders won by 3 wickets

TESTJaiswal 118

INDIndia224 & 396

ENGEngland247/9 & 367

India tour of England

India won by 6 runs

GT155/8

RCB161/5

PP 1-645/270/2

MID 7-1560/369/3

DEATH 16-2050/322/0

18 ovRoyal Challengers Bengaluru won by 5 wickets

75*V Kohli · 42 balls

OpenCricketFINALS

INDIAN PREMIER LEAGUE

GTGT

155/8

RCBRCB

161/5

MEN'S T20 WORLD CUP

INDIND

255/5

NZNZ

159

THE HUNDRED MEN'S COMPETITION

TRRTRR

158/8

MSGMSG

162/5

THE API, IN MOTION

Inspect a match. Then inspect the JSON.

Switch between a normalized cricket view and the API response behind it. Three real matches, every ball included.

GET/v1/matches/match_cs_1535465/overs Source: CricsheetJSON · REST

Gujarat Titans155/8

RCB

Royal Challengers Bengaluru161/5

Royal Challengers Bengaluru won by 5 wicketsIndian Premier League · FinalNarendra Modi Stadium, Ahmedabad31 May 2026

MANHATTAN

Runs in every over, both innings.

GT 155/8RCB 161/5Wicket

WORM

The chase, over by over.

Gujarat Titans

Powerplay 1-645/2

Middle 7-1560/3

Death 16-2050/3

Royal Challengers Bengaluru

Powerplay 1-670/2

Middle 7-1569/3

Death 16-2022/0

TOSSRoyal Challengers Bengaluru, chose to field

PLAYER OF THE MATCHV Kohli

UMPIRESKN Ananthapadmanabhan, Nitin Menon

LICENCEODC-By 1.0

ONE LAYER · FOUR JOBS

Less plumbing. More product.

Clean interfaces for match discovery, ball-by-ball detail, analytics and agent workflows.

01 · ONE CONTRACT

Cricket data without the translation layer.

13 resource-oriented endpoints, normalized JSON envelopes, deterministic IDs and cursor pagination across every format.

02 · EVERY BALL

Available means available. Nothing invented.

11.6M recorded deliveries with batter, bowler, extras, wickets and fielders. Missing fields stay missing. Nothing is estimated.

03 · MATCH INTELLIGENCE

From scorecard to context in one request.

Over-by-over runs, partnerships, powerplay and death-over splits, and batter-versus-bowler matchups derived from the deliveries.

04 · AI-NATIVE

REST for your app. MCP for your agents.

12 MCP tools expose the same contract to Claude Desktop, Cursor and custom agent workflows.

Read the documentation

01—03 / OPENCRICKET FLOWOne contract.
Three moves.

Cards rotate automatically. Hover or focus to hold.

Pick a competition

Resolve leagues, ICC events, teams and seasons through stable catalog IDs.

Call one endpoint

Use familiar REST filters or connect the MCP server to an agent.

Ship with provenance

Keep source and licence metadata attached to every factual response.

ENGINEERING NOTES

Useful before your first request.

View all guides

01 · API fundamentals

Cricket Data API Guide: Scorecards, Deliveries and Match Context

What a cricket data API returns, why ball-by-ball data matters, and what to check before you build on one.

Read guide

02 · Open data

Free Cricket API: What Open Ball-by-Ball Data Can and Cannot Do

Open cricket data is deep and free to use with attribution. Here is exactly what it covers, and where its limits are.

Read guide

03 · JavaScript

How to Build Manhattan and Worm Charts from a Cricket API

Turn over-by-over data into the two charts every cricket fan knows, with plain JavaScript and no chart library.

Read guide

STRAIGHT ANSWERS

Before you build.

What is OpenCricket API?

OpenCricket API is a REST cricket data API with ball-by-ball deliveries, scorecards, partnerships, phase splits and player matchups for 22,983 matches since 2001, plus an MCP server for AI agents.

Which competitions are covered?

Men's and women's Tests, ODIs and T20Is, every ICC event in the archive, and 49 club competitions including the IPL, Big Bash League, PSL, CPL, SA20, The Hundred, the County Championship and the Sheffield Shield. Teams from 109 nations appear in the archive.

Is the data live?

Not yet. The archive is complete, ball-by-ball history, refreshed as new matches are published. Live ball-by-ball scoring is planned for a later release and will be labelled clearly when it arrives. Archive data is never presented as a live feed.

Where does the data come from?

Match data comes from Cricsheet, released under the Open Data Commons Attribution License. Every response carries the source and licence, so you can attribute it in your own product.

Can I use it now?

The API contract and the examples on this site are public. Keys open to the waitlist first. The Starter plan stays free with 5,000 requests per month.

DEVELOPER PLAN

Start with real cricket data.

250,000 monthly requests, every delivery, partnerships, phase splits and all 12 MCP tools.

$14 / monthJoin the waitlist

The open cricket API, ball by ball.Ready for your apps and AI agents.

109 cricket nations. Every ball you can query.

Three widgets. One data contract.Paste OpenCricket into any site.

Inspect a match. Then inspect the JSON.

Runs in every over, both innings.

The chase, over by over.

Less plumbing. More product.

Cricket data without the translation layer.

Available means available. Nothing invented.

From scorecard to context in one request.

REST for your app. MCP for your agents.

Workflow

Pick a competition

Call one endpoint

Ship with provenance

Useful before your first request.

Cricket Data API Guide: Scorecards, Deliveries and Match Context

Free Cricket API: What Open Ball-by-Ball Data Can and Cannot Do

How to Build Manhattan and Worm Charts from a Cricket API

Before you build.

Start with real cricket data.