{ "info": { "_postman_id": "cricketdatabase-a447fa4e38741b968279e398", "name": "Cricket Database API", "description": "Set the apiKey variable to your key (a free key is at https://cricketdatabase.com/#free-key). Docs: https://cricketdatabase.com/documentation", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.cricketdatabase.com/v1" }, { "key": "apiKey", "value": "" } ], "item": [ { "name": "Account and reference", "item": [ { "name": "Usage", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/usage", "host": [ "{{baseUrl}}" ], "path": [ "usage" ] }, "description": "Calls today, the daily limit, when it resets, and which plan the key is on.\n\nhttps://cricketdatabase.com/documentation/usage" } }, { "name": "Status", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/status", "host": [ "{{baseUrl}}" ], "path": [ "status" ] }, "description": "The latest update, match, delivery and people counts. No key needed; use it as a health check.\n\nhttps://cricketdatabase.com/documentation/status" } }, { "name": "Search", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/search?q=root", "host": [ "{{baseUrl}}" ], "path": [ "search" ], "query": [ { "key": "q", "value": "root" } ] }, "description": "Players, teams, venues and competitions by name, including the other names a player has been recorded under.\n\nhttps://cricketdatabase.com/documentation/search" } } ] }, { "name": "Matches", "item": [ { "name": "Matches", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/matches?format=test&year=2025", "host": [ "{{baseUrl}}" ], "path": [ "matches" ], "query": [ { "key": "format", "value": "test" }, { "key": "year", "value": "2025" } ] }, "description": "Matches, newest first, filtered and paged: ball by ball from December 2001, and every men's Test, ODI and T20 international back to 1877 with its scorecard (coverage scorecard), its innings totals (coverage totals) or its result (coverage result_only). The free key and Match Week see the last 30 days.\n\nhttps://cricketdatabase.com/documentation/matches" } }, { "name": "Match", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/matches/2026-09-17-sri-lanka-v-england", "host": [ "{{baseUrl}}" ], "path": [ "matches", "2026-09-17-sri-lanka-v-england" ] }, "description": "One match: teams, result, toss, venue, officials, player of the match and the innings totals. An international held without its balls answers coverage scorecard or totals, with each innings, its extras and fall of wickets, or result_only. Older than 30 days on the free key comes back as a summary.\n\nhttps://cricketdatabase.com/documentation/match" } }, { "name": "Scorecard", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/matches/2026-09-17-sri-lanka-v-england/scorecard", "host": [ "{{baseUrl}}" ], "path": [ "matches", "2026-09-17-sri-lanka-v-england", "scorecard" ] }, "description": "Every innings: batting with dismissals, bowling, extras, did not bat and fall of wickets, and weather: each day's highest and lowest temperature, rain, humidity, dew point and wind at the ground.\n\nhttps://cricketdatabase.com/documentation/scorecard" } }, { "name": "Deliveries", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/matches/2026-09-17-sri-lanka-v-england/deliveries", "host": [ "{{baseUrl}}" ], "path": [ "matches", "2026-09-17-sri-lanka-v-england", "deliveries" ] }, "description": "Every ball, with batter, non-striker, bowler, runs, extras and wickets. Match Week reads the last 7 days, Archive everything to yesterday, Pro and Analyst Pro everything. Players come once in a dictionary; balls carry their addresses.\n\nhttps://cricketdatabase.com/documentation/deliveries" } }, { "name": "Overs", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/matches/2026-09-17-sri-lanka-v-england/overs", "host": [ "{{baseUrl}}" ], "path": [ "matches", "2026-09-17-sri-lanka-v-england", "overs" ] }, "description": "Over by over: runs, wickets, extras, the running total and the bowler.\n\nhttps://cricketdatabase.com/documentation/overs" } }, { "name": "Partnerships", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/matches/2026-09-17-sri-lanka-v-england/partnerships", "host": [ "{{baseUrl}}" ], "path": [ "matches", "2026-09-17-sri-lanka-v-england", "partnerships" ] }, "description": "Every partnership, worked out from the balls: the pair, runs, balls and how it ended.\n\nhttps://cricketdatabase.com/documentation/partnerships" } }, { "name": "DRS reviews", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/matches/2026-09-17-sri-lanka-v-england/reviews", "host": [ "{{baseUrl}}" ], "path": [ "matches", "2026-09-17-sri-lanka-v-england", "reviews" ] }, "description": "Every DRS review: the ball, who asked, the batter, the umpire, the decision and umpire's call.\n\nhttps://cricketdatabase.com/documentation/reviews" } }, { "name": "Latest results", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/results/yesterday", "host": [ "{{baseUrl}}" ], "path": [ "results", "yesterday" ] }, "description": "Every result from the latest day in the database.\n\nhttps://cricketdatabase.com/documentation/results-yesterday" } } ] }, { "name": "Live", "item": [ { "name": "Live matches", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/live?state=all", "host": [ "{{baseUrl}}" ], "path": [ "live" ], "query": [ { "key": "state", "value": "all" } ] }, "description": "Every match in play now, men and women, international and domestic, with the score of each innings and the state of play in words. Updated every minute. state=upcoming lists matches starting in the next 24 hours, finished those of the last 48 hours. ball_by_ball says whether the match has every ball; some domestic matches have the score only.\n\nhttps://cricketdatabase.com/documentation/live" } }, { "name": "A live match", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/live/{live}", "host": [ "{{baseUrl}}" ], "path": [ "live", "{live}" ] }, "description": "One live match: the score, the batting and bowling of every innings so far, who is in and on strike, the bowler, the partnership, the run rate, the chase (target, runs needed, balls left and required rate) and the last 12 balls as marks (. 1 4 6 W 1wd 2nb 1lb 1b). last_ball is the cursor to pass to the balls endpoint.\n\nhttps://cricketdatabase.com/documentation/live-match" } }, { "name": "Live deliveries", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/live/{live}/balls", "host": [ "{{baseUrl}}" ], "path": [ "live", "{live}", "balls" ] }, "description": "Every ball of a live match in order, with the same fields as deliveries: batter, partner, bowler, runs, extras and wickets. Pass after (the next value of the last answer, or last_ball from the match) to get only the balls bowled since, so a poll every minute costs one call. A ball corrected by the scorers takes the place of the first version.\n\nhttps://cricketdatabase.com/documentation/live-balls" } }, { "name": "Live stream", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/live/stream", "host": [ "{{baseUrl}}" ], "path": [ "live", "stream" ] }, "description": "Live scores pushed instead of polled: one connection sends server-sent events as they happen. snapshot on connect (every match in play, as /v1/live gives it), score when a match's score or state changes, and ball for every new ball (as /v1/live/{match}/balls gives it, with its match). match= follows one match only. Send the key in a header as on every call, so read it with any SSE client on a server (curl -N, Python sseclient, Node eventsource). Each event carries an id: a client that reconnects sends it back by itself and carries on with no ball missed or repeated. A connection lasts 2 minutes and the client reconnects by itself; each connection counts as one call, and a key holds up to 2 at once. For the balls already bowled, call /v1/live/{match}/balls once, then follow the stream.\n\nhttps://cricketdatabase.com/documentation/live-stream" } } ] }, { "name": "Players", "item": [ { "name": "Players", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players?q=kohli", "host": [ "{{baseUrl}}" ], "path": [ "players" ], "query": [ { "key": "q", "value": "kohli" } ] }, "description": "Players who have played, most matches first, or matched by name.\n\nhttps://cricketdatabase.com/documentation/players" } }, { "name": "Player", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/je-root", "host": [ "{{baseUrl}}" ], "path": [ "players", "je-root" ] }, "description": "A player: teams with match counts, first and latest match, birth and death details (born, birthplace, died, deathplace, nationality) and playing style (batting_style, bowling_style), each null when not known. Dates are YYYY-MM-DD, or YYYY-MM or YYYY when only that much is known.\n\nhttps://cricketdatabase.com/documentation/player" } }, { "name": "Career stats", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/je-root/stats", "host": [ "{{baseUrl}}" ], "path": [ "players", "je-root", "stats" ] }, "description": "Career batting and bowling by format.\n\nhttps://cricketdatabase.com/documentation/player-stats" } }, { "name": "Batting log", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/je-root/innings", "host": [ "{{baseUrl}}" ], "path": [ "players", "je-root", "innings" ] }, "description": "Every batting innings, newest first. Lower plans get the last ten.\n\nhttps://cricketdatabase.com/documentation/player-innings" } }, { "name": "Bowling log", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/players/je-root/bowling", "host": [ "{{baseUrl}}" ], "path": [ "players", "je-root", "bowling" ] }, "description": "Every bowling spell, newest first. Lower plans get the last ten.\n\nhttps://cricketdatabase.com/documentation/player-bowling" } } ] }, { "name": "Teams", "item": [ { "name": "Teams", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams", "host": [ "{{baseUrl}}" ], "path": [ "teams" ] }, "description": "Every team, international or club, with match counts.\n\nhttps://cricketdatabase.com/documentation/teams" } }, { "name": "Team", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/england", "host": [ "{{baseUrl}}" ], "path": [ "teams", "england" ] }, "description": "A team: record by format, main competitions and most-capped players.\n\nhttps://cricketdatabase.com/documentation/team" } }, { "name": "Team matches", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/england/matches", "host": [ "{{baseUrl}}" ], "path": [ "teams", "england", "matches" ] }, "description": "A team's matches, with every filter of /v1/matches.\n\nhttps://cricketdatabase.com/documentation/team-matches" } }, { "name": "Head to head", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/teams/england/head-to-head/australia", "host": [ "{{baseUrl}}" ], "path": [ "teams", "england", "head-to-head", "australia" ] }, "description": "Two teams against each other, by format, with the last ten meetings.\n\nhttps://cricketdatabase.com/documentation/head-to-head" } } ] }, { "name": "Venues", "item": [ { "name": "Venues", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/venues", "host": [ "{{baseUrl}}" ], "path": [ "venues" ] }, "description": "Every ground, with city and match counts.\n\nhttps://cricketdatabase.com/documentation/venues" } }, { "name": "Venue", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/venues/sophia-gardens", "host": [ "{{baseUrl}}" ], "path": [ "venues", "sophia-gardens" ] }, "description": "A ground: matches by format, highest totals and most runs there.\n\nhttps://cricketdatabase.com/documentation/venue" } }, { "name": "Venue matches", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/venues/sophia-gardens/matches", "host": [ "{{baseUrl}}" ], "path": [ "venues", "sophia-gardens", "matches" ] }, "description": "Matches at a ground, with every filter of /v1/matches.\n\nhttps://cricketdatabase.com/documentation/venue-matches" } } ] }, { "name": "Competitions", "item": [ { "name": "Competitions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/competitions", "host": [ "{{baseUrl}}" ], "path": [ "competitions" ] }, "description": "Every competition, with kind, gender, span and match count.\n\nhttps://cricketdatabase.com/documentation/competitions" } }, { "name": "Competition", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/competitions/t20-blast", "host": [ "{{baseUrl}}" ], "path": [ "competitions", "t20-blast" ] }, "description": "A competition: the names it was filed under, titles by team and all-time leaders.\n\nhttps://cricketdatabase.com/documentation/competition" } }, { "name": "Seasons", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/competitions/t20-blast/seasons", "host": [ "{{baseUrl}}" ], "path": [ "competitions", "t20-blast", "seasons" ] }, "description": "Every season with its champion, final and top run scorer and wicket taker.\n\nhttps://cricketdatabase.com/documentation/seasons" } }, { "name": "Season", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/competitions/t20-blast/seasons/2025", "host": [ "{{baseUrl}}" ], "path": [ "competitions", "t20-blast", "seasons", "2025" ] }, "description": "A season: every result, the results table and the leaders. Seasons like 2025/26 are written 2025-26.\n\nhttps://cricketdatabase.com/documentation/season" } } ] }, { "name": "Records", "item": [ { "name": "Records", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/records?type=most-runs&format=test", "host": [ "{{baseUrl}}" ], "path": [ "records" ], "query": [ { "key": "type", "value": "most-runs" }, { "key": "format", "value": "test" } ] }, "description": "Record lists. Lower plans get the top 10; Archive and Analyst Pro the top 100.\n\nhttps://cricketdatabase.com/documentation/records" } } ] }, { "name": "Analytics", "item": [ { "name": "Matchups", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/matchups?batter=je-root&bowler=pj-cummins", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "matchups" ], "query": [ { "key": "batter", "value": "je-root" }, { "key": "bowler", "value": "pj-cummins" } ] }, "description": "Batter against bowler: balls, runs, dismissals, strike rate and average. Analyst Pro adds dots, boundaries, how out and every format separately.\n\nhttps://cricketdatabase.com/documentation/matchups" } }, { "name": "[Analyst Pro] Splits", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/players/je-root/splits", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "players", "je-root", "splits" ] }, "description": "Batting by opposition, venue, year, innings and position; bowling by opposition, venue, year and innings.\n\nhttps://cricketdatabase.com/documentation/splits" } }, { "name": "[Analyst Pro] Phases", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/players/je-root/phases?format=t20i", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "players", "je-root", "phases" ], "query": [ { "key": "format", "value": "t20i" } ] }, "description": "Powerplay, middle and death: strike rate, dot and boundary rates and dismissals; bowling economy and wickets.\n\nhttps://cricketdatabase.com/documentation/phases" } }, { "name": "[Analyst Pro] Dismissals", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/players/je-root/dismissals", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "players", "je-root", "dismissals" ] }, "description": "How a player gets out: by kind, by bowler and by balls faced.\n\nhttps://cricketdatabase.com/documentation/dismissals" } }, { "name": "[Analyst Pro] Scoring shape", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/players/je-root/scoring", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "players", "je-root", "scoring" ] }, "description": "Scoring shape: the share of dots, singles, twos, threes, fours and sixes, boundary runs and sixes per 100 balls.\n\nhttps://cricketdatabase.com/documentation/scoring" } }, { "name": "Rolling form", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/players/je-root/form", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "players", "je-root", "form" ] }, "description": "Rolling average and strike rate over recent innings. Lower plans get the last five.\n\nhttps://cricketdatabase.com/documentation/form" } }, { "name": "[Analyst Pro] Par scores", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/venues/sophia-gardens/par-scores", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "venues", "sophia-gardens", "par-scores" ] }, "description": "First-innings totals by format and year: average, median, highest, lowest, and batting first against chasing.\n\nhttps://cricketdatabase.com/documentation/par-scores" } }, { "name": "[Analyst Pro] Toss effect", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/venues/sophia-gardens/toss", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "venues", "sophia-gardens", "toss" ] }, "description": "How often the toss winner bats, and how often they win after batting or fielding.\n\nhttps://cricketdatabase.com/documentation/toss" } }, { "name": "[Analyst Pro] Team phases", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/teams/england/phases?format=t20i", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "teams", "england", "phases" ], "query": [ { "key": "format", "value": "t20i" } ] }, "description": "A team's run rate and wickets by phase, batting and bowling, year by year.\n\nhttps://cricketdatabase.com/documentation/team-phases" } }, { "name": "[Analyst Pro] Competition trends", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/competitions/t20-blast/trends", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "competitions", "t20-blast", "trends" ] }, "description": "Season by season: first-innings average, run rate, runs per wicket, boundaries per match and chase wins.\n\nhttps://cricketdatabase.com/documentation/trends" } }, { "name": "[Analyst Pro] Chases", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/chases?format=t20i", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "chases" ], "query": [ { "key": "format", "value": "t20i" } ] }, "description": "Chase success by target band. Rain-affected chases are left out.\n\nhttps://cricketdatabase.com/documentation/chases" } }, { "name": "Worm", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/matches/2026-09-17-sri-lanka-v-england/worm", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "matches", "2026-09-17-sri-lanka-v-england", "worm" ] }, "description": "Runs and wickets per over and the running totals for every innings, for worm and Manhattan charts.\n\nhttps://cricketdatabase.com/documentation/worm" } }, { "name": "Win probability", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/analytics/matches/2026-09-17-sri-lanka-v-england/win-probability", "host": [ "{{baseUrl}}" ], "path": [ "analytics", "matches", "2026-09-17-sri-lanka-v-england", "win-probability" ] }, "description": "After each over of a one-day or T20 match, how likely the batting side was to win, from models fitted on our own ball-by-ball record of completed matches: one for the first innings, one for the chase. model gives when they were fitted, how many matches they learned from, and their Brier score on matches held back from fitting (0 is perfect, 0.25 is a coin toss).\n\nhttps://cricketdatabase.com/documentation/win-probability" } } ] }, { "name": "Bulk files", "item": [ { "name": "Bulk files", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/export?table=matches&format=csv", "host": [ "{{baseUrl}}" ], "path": [ "export" ], "query": [ { "key": "table", "value": "matches" }, { "key": "format", "value": "csv" } ] }, "description": "Every match held ball by ball as files to download instead of pages to call: matches, innings, batting, bowling and every ball, one file a year for each, and one file each for players, teams and grounds, as gzipped CSV or gzipped JSON lines. Each entry gives its rows, size, sha256 and download address. Files are rebuilt each night up to yesterday, a year only when its matches changed. Addresses in the files are the same as everywhere in the API.\n\nhttps://cricketdatabase.com/documentation/export" } }, { "name": "Download a bulk file", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/export/players-csv", "host": [ "{{baseUrl}}" ], "path": [ "export", "players-csv" ] }, "description": "One bulk file, sent as it is: gzipped CSV (a header row, then one row a record) or gzipped JSON lines (one object a line), with Content-Length, an ETag of its sha256 and X-Rows. Each download counts as one call. The example shows the file's entry; the call itself answers the file.\n\nhttps://cricketdatabase.com/documentation/export-file" } } ] } ] }