Guides
Read these before the reference: they are the difference between a call that works and an integration that behaves.
Start here
01Getting startedYour first call in a minute: the base address, your key and the shape of a response.
02AuthenticationSend your key as a bearer token or as X-API-Key, and keep it off the browser.
03What each plan can callEvery endpoint on every plan: in full, in a window, to yesterday, as a sample, or not at all.
04AddressesHow matches, players, teams, venues and competitions are addressed, and what happens when two share a name.
05Use with Claude and agentsThe agent skill and the MCP server: let Claude, Cursor or any agent look cricket up for you on your own key.
Reading a response
06Deliveries and extrasHow a ball is numbered, what counts as legal, and how wides, no-balls, byes and leg-byes are recorded.
07Scorecards and dismissalsBatting, bowling, fall of wickets and how each kind of dismissal reads.
08Formats and competitionsThe six formats, and how a competition keeps one address across its sponsors' names.
09Players and their namesName variants, and who counts as a player.
Limits and delivery
10Limits and headersTwo limits per plan, calls a minute and calls a day, what counts, when each resets and the headers that tell you.
11ErrorsOne error shape, nine codes, and what to do about each.
12Pagingpage or cursor, per_page, and walking a long list politely.
13Data freshnessWhen new matches arrive, and how to know what you are looking at is current.