Live matches
GET
/v1/liveOn each planFree keyNot includedMatch WeekIn fullArchiveNot includedProIn fullAnalyst ProIn fullMCP toollive_scores
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.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
state | query | live (the default), upcoming, finished or all | |
format | query | Test, ODI, T20I, T20, First-class, List A | |
international | query | true for Tests, ODIs and T20 internationals only |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/live?state=all"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/live?state=all",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/live?state=all",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/live?state=all"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/live?state=all",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/live?state=all",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"count": 58,
"results": [
{
"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"
},
{
"match": "2026-10-09-south-africa-v-australia",
"name": "South Africa v Australia",
"competition": "Australia tour of South Africa 2026/27",
"format": "Test",
"state": "live",
"international": true,
"women": false,
"status": "South Africa require 319 runs",
"starts_at": "2026-10-09T07:30:00Z",
"venue": "Kingsmead, Durban",
"city": "Durban",
"teams": [
{
"name": "South Africa",
"score": "284 & 102/4 (41 ov, target 421)"
},
{
"name": "Australia",
"score": "390 & 314/6d"
}
],
"innings": [
{
"innings": 1,
"team": "Australia",
"runs": 390,
"wickets": 10,
"overs": "137.2",
"chase_target": null,
"innings_declared": false
},
{
"innings": 2,
"team": "Australia",
"runs": 0,
"wickets": 0,
"overs": "78",
"chase_target": null,
"innings_declared": false
},
"... 2 more"
],
"ball_by_ball": true,
"batting": "Australia",
"winner": null,
"updated_at": "2026-10-12T21:42:06Z"
},
"... 56 more"
]
},
"meta": {
"plan": "plus",
"window": {
"updated_every": "1 minute",
"last_update": "2026-10-12T21:41:49Z"
},
"count": 58
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.