Deliveries
GET
/v1/matches/{match}/deliveriesOn each planFree keySampleMatch WeekLast 7 daysArchiveTo yesterdayProIn fullAnalyst ProIn fullMCP toolget_deliveries
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.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
match | path | match address | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england/deliveries"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england/deliveries",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england/deliveries",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england/deliveries"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england/deliveries",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/matches/2026-09-17-sri-lanka-v-england/deliveries",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"match": "2026-09-17-sri-lanka-v-england",
"count": 200,
"players": {
"p-nissanka": "P Nissanka",
"lu-igalagamage": "LU Igalagamage",
"s-baker": "S Baker",
"jc-archer": "JC Archer",
"wg-jacks": "WG Jacks",
"la-dawson": "LA Dawson",
"k-mishara": "K Mishara",
"kic-asalanka": "KIC Asalanka",
"j-overton": "J Overton",
"phkd-mendis": "PHKD Mendis",
"au-rashid": "AU Rashid",
"md-shanaka": "MD Shanaka",
"pwh-de-silva": "PWH de Silva",
"kth-ratnayake": "KTH Ratnayake",
"pvd-chameera": "PVD Chameera",
"e-malinga": "E Malinga",
"jc-buttler": "JC Buttler",
"aht-donald": "AHT Donald",
"d-madushanka": "D Madushanka",
"hc-brook": "HC Brook",
"t-banton": "T Banton",
"jm-cox": "JM Cox"
},
"deliveries": [
{
"innings": 1,
"over": 1,
"ball": 1,
"batter": "p-nissanka",
"partner": "lu-igalagamage",
"bowler": "s-baker",
"runs": {
"batter": 2,
"extras": 0,
"total": 2
}
},
{
"innings": 1,
"over": 1,
"ball": 2,
"batter": "p-nissanka",
"partner": "lu-igalagamage",
"bowler": "s-baker",
"runs": {
"batter": 1,
"extras": 0,
"total": 1
}
},
"... 198 more"
]
},
"meta": {
"plan": "plus",
"held_back": 0
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.