Live deliveries
GET
/v1/live/{match}/ballsOn each planFree keyNot includedMatch WeekIn fullArchiveNot includedProIn fullAnalyst ProIn full
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.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
match | path | match address | yes |
after | query | The next value from an earlier answer |
Request
curl -H "Authorization: Bearer $CDB_KEY" \
"https://api.cricketdatabase.com/v1/live/{live}/balls"import requests
r = requests.get("https://api.cricketdatabase.com/v1/live/{live}/balls",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/live/{live}/balls",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \
"https://api.cricketdatabase.com/v1/live/{live}/balls"import requests
r = requests.get("https://api.cricketdatabase.com/v1/live/{live}/balls",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/live/{live}/balls",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"match": "2026-10-09-afghanistan-v-bangladesh",
"count": 600,
"deliveries": [
{
"innings": 1,
"over": 1,
"ball": 1,
"batter": {
"player": "shadman-islam",
"name": "Shadman Islam"
},
"partner": {
"player": "tanzid-hasan",
"name": "Tanzid Hasan"
},
"bowler": {
"player": "yamin-ahmadzai",
"name": "Yamin Ahmadzai"
},
"runs": {
"batter": 2,
"extras": 0,
"total": 2
}
},
{
"innings": 1,
"over": 1,
"ball": 2,
"batter": {
"player": "shadman-islam",
"name": "Shadman Islam"
},
"partner": {
"player": "tanzid-hasan",
"name": "Tanzid Hasan"
},
"bowler": {
"player": "yamin-ahmadzai",
"name": "Yamin Ahmadzai"
},
"runs": {
"batter": 0,
"extras": 0,
"total": 0
}
},
"... 598 more"
],
"next": "Y2RiOmxiMjAwNzAy",
"more": true
},
"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.