A live match
GET
/v1/live/{match}On each planFree keyNot includedMatch WeekIn fullArchiveNot includedProIn fullAnalyst ProIn fullMCP toollive_match
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.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
match | path | match address | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \
"https://api.cricketdatabase.com/v1/live/{live}"import requests
r = requests.get("https://api.cricketdatabase.com/v1/live/{live}",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/live/{live}",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \
"https://api.cricketdatabase.com/v1/live/{live}"import requests
r = requests.get("https://api.cricketdatabase.com/v1/live/{live}",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/live/{live}",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"match": "2026-10-09-afghanistan-v-bangladesh",
"name": "Afghanistan v Bangladesh",
"competition": "Bangladesh tour of United Arab Emirates 2026/27",
"format": "Test",
"state": "live",
"international": true,
"women": false,
"status": "Afghanistan require 347 runs",
"starts_at": "2026-10-09T06:00:00Z",
"venue": "Zayed Cricket Stadium, Abu Dhabi",
"city": "Abu Dhabi",
"teams": [
{
"name": "Afghanistan",
"score": "240 & 132/3 (50 ov, target 479)"
},
{
"name": "Bangladesh",
"score": "346 & 372/7d"
}
],
"innings": [
{
"innings": 1,
"team": "Bangladesh",
"runs": 346,
"wickets": 10,
"overs": "92.3",
"chase_target": null,
"innings_declared": false
},
{
"innings": 2,
"team": "Bangladesh",
"runs": 0,
"wickets": 0,
"overs": "89.1",
"chase_target": null,
"innings_declared": false
},
"... 2 more"
],
"ball_by_ball": true,
"batting": "Bangladesh",
"winner": null,
"updated_at": "2026-10-12T21:42:05Z",
"toss": "Bangladesh , elected to bat first",
"scorecard": [
{
"innings": 1,
"team": "Bangladesh",
"runs": 347,
"wickets": 10,
"overs": "92.3",
"run_rate": 3.75,
"extras": 9,
"extras_detail": {
"no_balls": 1,
"byes": 4,
"leg_byes": 4
},
"batting": [
{
"player": "shadman-islam",
"name": "Shadman Islam",
"runs": 66,
"balls": 115,
"fours": 7,
"sixes": 0,
"out": true,
"how_out": "caught",
"dismissal": "c Zia-ur-Rehman b Mohammad Saleem",
"strike_rate": 57.4
},
{
"player": "tanzid-hasan",
"name": "Tanzid Hasan",
"runs": 83,
"balls": 71,
"fours": 8,
"sixes": 4,
"out": true,
"how_out": "caught",
"dismissal": "c Ikram Alikhil b Ismat Alam",
"strike_rate": 116.9
},
"... 9 more"
],
"bowling": [
{
"player": "yamin-ahmadzai",
"name": "Yamin Ahmadzai",
"overs": "20.3",
"maidens": 3,
"runs": 78,
"wickets": 3,
"economy": 3.8,
"dots": 85,
"fours": 7,
"sixes": 2,
"wides": 0,
"no_balls": 0
},
{
"player": "mohammad-saleem",
"name": "Mohammad Saleem",
"overs": "23",
"maidens": 2,
"runs": 79,
"wickets": 4,
"economy": 3.43,
"dots": 96,
"fours": 10,
"sixes": 0,
"wides": 0,
"no_balls": 1
},
"... 4 more"
]
},
{
"innings": 2,
"team": "Bangladesh",
"runs": 242,
"wickets": 10,
"overs": "89.1",
"run_rate": 2.71,
"extras": 2,
"extras_detail": {
"no_balls": 1,
"leg_byes": 1
},
"batting": [
{
"player": "sediqullah-atal",
"name": "Sediqullah Atal",
"runs": 17,
"balls": 32,
"fours": 3,
"sixes": 0,
"out": true,
"how_out": "caught",
"dismissal": "c Najmul Hossain Shanto b Hasan Mahmud",
"strike_rate": 53.1
},
{
"player": "abdul-malik",
"name": "Abdul Malik",
"runs": 64,
"balls": 120,
"fours": 4,
"sixes": 1,
"out": true,
"how_out": "caught",
"dismissal": "c Litton Das b Ebadot Hossain",
"strike_rate": 53.3
},
"... 9 more"
],
"bowling": [
{
"player": "hasan-mahmud",
"name": "Hasan Mahmud",
"overs": "21",
"maidens": 5,
"runs": 56,
"wickets": 5,
"economy": 2.67,
"dots": 96,
"fours": 5,
"sixes": 1,
"wides": 0,
"no_balls": 1
},
{
"player": "ebadat-hossain",
"name": "Ebadot Hossain",
"overs": "15.1",
"maidens": 3,
"runs": 55,
"wickets": 4,
"economy": 3.63,
"dots": 60,
"fours": 6,
"sixes": 0,
"wides": 0,
"no_balls": 0
},
"... 4 more"
]
},
"... 2 more"
],
"now": {
"innings": 4,
"batting": [
{
"player": "sediqullah-atal",
"name": "Sediqullah Atal",
"runs": 35,
"balls": 126,
"fours": 1,
"sixes": 1,
"strike_rate": 27.8,
"on_strike": true
},
{
"player": "hashmatullah-shahidi",
"name": "Hashmatullah Shahidi",
"runs": 19,
"balls": 27,
"fours": 2,
"sixes": 1,
"strike_rate": 70.4,
"on_strike": false
}
],
"bowler": {
"player": "hasan-mahmud",
"name": "Hasan Mahmud",
"overs": "12",
"maidens": 0,
"runs": 31,
"wickets": 1,
"economy": 2.58
},
"over": {
"over": 50,
"ball": 6
},
"last_overs": [
{
"over": 48,
"bowler": "Hasan Mahmud",
"balls": [
".",
"4",
"... 4 more"
],
"runs": 4
},
{
"over": 49,
"bowler": "Ebadot Hossain",
"balls": [
"1",
".",
"... 4 more"
],
"runs": 5
},
"... 1 more"
],
"partnership": {
"runs": 22,
"balls": 47
},
"run_rate": 2.64,
"recent": [
"1",
".",
"... 10 more"
],
"chase": {
"target": 479,
"need": 347
}
},
"last_ball": "Y2RiOmxiNDA0OTA2"
},
"meta": {
"plan": "plus",
"window": {
"updated_every": "1 minute",
"last_update": "2026-10-12T21:42:45Z"
}
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.