Season
GET
/v1/competitions/{competition}/seasons/{season}On each planFree keyIn fullMatch WeekIn fullArchiveIn fullProIn fullAnalyst ProIn full
A season: every result, the results table and the leaders. Seasons like 2025/26 are written 2025-26.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
competition | path | competition address | yes |
season | path | season address | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons/2025"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons/2025",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons/2025",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons/2025"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons/2025",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons/2025",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"competition": "t20-blast",
"season": "2025",
"matches": 132,
"champion": "Somerset",
"table": [
{
"team": "somerset",
"name": "Somerset",
"played": 17,
"won": 14,
"lost": 3,
"no_result": 0
},
{
"team": "surrey",
"name": "Surrey",
"played": 15,
"won": 11,
"lost": 4,
"no_result": 0
},
"... 16 more"
],
"most_runs": [
{
"player": "te-albert",
"name": "TE Albert",
"runs": 633,
"innings": 17,
"high_score": 98
},
{
"player": "wcf-smeed",
"name": "WCF Smeed",
"runs": 620,
"innings": 17,
"high_score": 94
},
"... 6 more"
],
"most_wickets": [
{
"player": "rp-meredith",
"name": "RP Meredith",
"wickets": 28,
"economy": 8.62
},
{
"player": "sw-currie",
"name": "SW Currie",
"wickets": 27,
"economy": 8.65
},
"... 6 more"
],
"results": [
{
"match": "2025-09-13-hampshire-v-somerset",
"date": "2025-09-13",
"teams": [
{
"name": "Hampshire",
"score": "194/6",
"won": false
},
{
"name": "Somerset",
"score": "195/4",
"won": true
}
],
"result": "Somerset won by 6 wickets",
"stage": "Final"
},
{
"match": "2025-09-13-northamptonshire-v-hampshire",
"date": "2025-09-13",
"teams": [
{
"name": "Northamptonshire",
"score": "158/7",
"won": false
},
{
"name": "Hampshire",
"score": "155/4",
"won": true
}
],
"result": "Hampshire won by 6 wickets (DLS)",
"stage": "Semi Final"
},
"... 130 more"
]
},
"meta": {
"plan": "plus"
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.