Batting log
GET
/v1/players/{player}/inningsOn each planFree keySampleMatch WeekSampleArchiveIn fullProIn fullAnalyst ProIn fullMCP toolplayer_innings
Every batting innings, newest first. Lower plans get the last ten.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
player | path | player address | yes |
format | query | test, odi, t20i, t20, multi-day, one-day | |
year | query | ||
page | query | Page number, from 1 | |
limit | query | Results per page, 1 to 100 (default 50) |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/players/je-root/innings"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/players/je-root/innings",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/players/je-root/innings",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/players/je-root/innings"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/players/je-root/innings",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/players/je-root/innings",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": [
{
"match": "2026-09-27-england-v-sri-lanka",
"date": "2026-09-27",
"format": "odi",
"team": "England",
"opponent": "Sri Lanka",
"innings": 1,
"runs": 18,
"balls": 37,
"fours": 1,
"sixes": 0,
"out": true,
"how_out": "lbw"
},
{
"match": "2026-09-24-sri-lanka-v-england",
"date": "2026-09-24",
"format": "odi",
"team": "England",
"opponent": "Sri Lanka",
"innings": 2,
"runs": 15,
"balls": 17,
"fours": 1,
"sixes": 0,
"out": true,
"how_out": "caught"
},
"... 48 more"
],
"meta": {
"plan": "plus",
"count": 50,
"next_cursor": "Y2RiOnAy",
"page": 1,
"per_page": 50,
"total": 655,
"total_pages": 14,
"next_page": 2,
"prev_page": null,
"player": "je-root"
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.