# Cricket Database > Every ball of cricket since December 2001. 47 REST endpoints covering international, franchise and domestic matches, men and women, and every Test, ODI and T20 international back to 1877: results, scorecards, every ball, live scores, players, teams, grounds, competitions, records and analytics. > Factual data only: no predictions, ratings or tips. ## Complete reference - [Full manual, one file](https://cricketdatabase.com/documentation/manual.md): every endpoint, parameter, sample response and guide in a single markdown document. - [OpenAPI](https://cricketdatabase.com/openapi.json): machine-readable API description. - [MCP server](https://cricketdatabase.com/mcp): Model Context Protocol endpoint. Its tools: https://cricketdatabase.com/documentation/mcp-tools ## Agent skill - [Cricket Database agent skill](https://cricketdatabase.com/.well-known/agent-skills/cricketdatabase/SKILL.md): how agents use Cricket Database. Index: https://cricketdatabase.com/.well-known/agent-skills/index.json ## Guides - [Getting started](https://cricketdatabase.com/documentation/guides/getting-started): Your first call in a minute: the base address, your key and the shape of a response. - [Authentication](https://cricketdatabase.com/documentation/guides/authentication): Send your key as a bearer token or as X-API-Key, and keep it off the browser. - [What each plan can call](https://cricketdatabase.com/documentation/guides/plans): Every endpoint on every plan: in full, in a window, to yesterday, as a sample, or not at all. - [Addresses](https://cricketdatabase.com/documentation/guides/addresses): How matches, players, teams, venues and competitions are addressed, and what happens when two share a name. - [Deliveries and extras](https://cricketdatabase.com/documentation/guides/deliveries): How a ball is numbered, what counts as legal, and how wides, no-balls, byes and leg-byes are recorded. - [Scorecards and dismissals](https://cricketdatabase.com/documentation/guides/scorecards): Batting, bowling, fall of wickets and how each kind of dismissal reads. - [Formats and competitions](https://cricketdatabase.com/documentation/guides/formats): The six formats, and how a competition keeps one address across its sponsors' names. - [Players and their names](https://cricketdatabase.com/documentation/guides/players): Name variants, and who counts as a player. - [Limits and headers](https://cricketdatabase.com/documentation/guides/limits): Two limits per plan, calls a minute and calls a day, what counts, when each resets and the headers that tell you. - [Errors](https://cricketdatabase.com/documentation/guides/errors): One error shape, nine codes, and what to do about each. - [Paging](https://cricketdatabase.com/documentation/guides/paging): page or cursor, per_page, and walking a long list politely. - [Data freshness](https://cricketdatabase.com/documentation/guides/freshness): When new matches arrive, and how to know what you are looking at is current. - [Coverage](https://cricketdatabase.com/documentation/guides/coverage): What is in the database by format and year, and where the record has gaps. - [Use with Claude and agents](https://cricketdatabase.com/documentation/guides/agents): The agent skill and the MCP server: let Claude, Cursor or any agent look cricket up for you on your own key. - [MCP server](https://cricketdatabase.com/documentation/guides/mcp): The API as tools for an assistant: add one address and your key, and Claude, Cursor or any MCP client looks cricket up for you. ## Endpoints - [GET /v1/usage](https://cricketdatabase.com/documentation/usage): Usage - [GET /v1/status](https://cricketdatabase.com/documentation/status): Status - [GET /v1/search](https://cricketdatabase.com/documentation/search): Search - [GET /v1/matches](https://cricketdatabase.com/documentation/matches): Matches - [GET /v1/matches/{match}](https://cricketdatabase.com/documentation/match): Match - [GET /v1/matches/{match}/scorecard](https://cricketdatabase.com/documentation/scorecard): Scorecard - [GET /v1/matches/{match}/deliveries](https://cricketdatabase.com/documentation/deliveries): Deliveries - [GET /v1/matches/{match}/overs](https://cricketdatabase.com/documentation/overs): Overs - [GET /v1/matches/{match}/partnerships](https://cricketdatabase.com/documentation/partnerships): Partnerships - [GET /v1/matches/{match}/reviews](https://cricketdatabase.com/documentation/reviews): DRS reviews - [GET /v1/results/yesterday](https://cricketdatabase.com/documentation/results-yesterday): Latest results - [GET /v1/live](https://cricketdatabase.com/documentation/live): Live matches - [GET /v1/live/{match}](https://cricketdatabase.com/documentation/live-match): A live match - [GET /v1/live/{match}/balls](https://cricketdatabase.com/documentation/live-balls): Live deliveries - [GET /v1/players](https://cricketdatabase.com/documentation/players): Players - [GET /v1/players/{player}](https://cricketdatabase.com/documentation/player): Player - [GET /v1/players/{player}/stats](https://cricketdatabase.com/documentation/player-stats): Career stats - [GET /v1/players/{player}/innings](https://cricketdatabase.com/documentation/player-innings): Batting log - [GET /v1/players/{player}/bowling](https://cricketdatabase.com/documentation/player-bowling): Bowling log - [GET /v1/teams](https://cricketdatabase.com/documentation/teams): Teams - [GET /v1/teams/{team}](https://cricketdatabase.com/documentation/team): Team - [GET /v1/teams/{team}/matches](https://cricketdatabase.com/documentation/team-matches): Team matches - [GET /v1/teams/{team}/head-to-head/{other}](https://cricketdatabase.com/documentation/head-to-head): Head to head - [GET /v1/venues](https://cricketdatabase.com/documentation/venues): Venues - [GET /v1/venues/{venue}](https://cricketdatabase.com/documentation/venue): Venue - [GET /v1/venues/{venue}/matches](https://cricketdatabase.com/documentation/venue-matches): Venue matches - [GET /v1/competitions](https://cricketdatabase.com/documentation/competitions): Competitions - [GET /v1/competitions/{competition}](https://cricketdatabase.com/documentation/competition): Competition - [GET /v1/competitions/{competition}/seasons](https://cricketdatabase.com/documentation/seasons): Seasons - [GET /v1/competitions/{competition}/seasons/{season}](https://cricketdatabase.com/documentation/season): Season - [GET /v1/records](https://cricketdatabase.com/documentation/records): Records - [GET /v1/analytics/matchups](https://cricketdatabase.com/documentation/matchups): Matchups - [GET /v1/analytics/players/{player}/splits](https://cricketdatabase.com/documentation/splits): Splits - [GET /v1/analytics/players/{player}/phases](https://cricketdatabase.com/documentation/phases): Phases - [GET /v1/analytics/players/{player}/dismissals](https://cricketdatabase.com/documentation/dismissals): Dismissals - [GET /v1/analytics/players/{player}/scoring](https://cricketdatabase.com/documentation/scoring): Scoring shape - [GET /v1/analytics/players/{player}/form](https://cricketdatabase.com/documentation/form): Rolling form - [GET /v1/analytics/venues/{venue}/par-scores](https://cricketdatabase.com/documentation/par-scores): Par scores - [GET /v1/analytics/venues/{venue}/toss](https://cricketdatabase.com/documentation/toss): Toss effect - [GET /v1/analytics/teams/{team}/phases](https://cricketdatabase.com/documentation/team-phases): Team phases - [GET /v1/analytics/competitions/{competition}/trends](https://cricketdatabase.com/documentation/trends): Competition trends - [GET /v1/analytics/chases](https://cricketdatabase.com/documentation/chases): Chases - [GET /v1/analytics/matches/{match}/worm](https://cricketdatabase.com/documentation/worm): Worm - [GET /v1/analytics/matches/{match}/win-probability](https://cricketdatabase.com/documentation/win-probability): Win probability - [GET /v1/export](https://cricketdatabase.com/documentation/export): Bulk files - [GET /v1/live/stream](https://cricketdatabase.com/documentation/live-stream): Live stream - [GET /v1/export/{file}](https://cricketdatabase.com/documentation/export-file): Download a bulk file ## Database pages - [Matches](https://cricketdatabase.com/matches) - [Live scores](https://cricketdatabase.com/live) - [Players](https://cricketdatabase.com/players) - [Teams](https://cricketdatabase.com/teams) - [Grounds](https://cricketdatabase.com/venues) - [Records](https://cricketdatabase.com/records) - [Competitions](https://cricketdatabase.com/competitions)