Seasons
GET
/v1/competitions/{competition}/seasonsOn each planFree keyIn fullMatch WeekIn fullArchiveIn fullProIn fullAnalyst ProIn full
Every season with its champion, final and top run scorer and wicket taker.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
competition | path | competition address | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons",
{ 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"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/competitions/t20-blast/seasons",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"competition": "t20-blast",
"seasons": [
{
"season": "2026",
"slug": "2026",
"matches": 115,
"from": "2026-05-22",
"to": "2026-07-18",
"champion": "Northamptonshire",
"final": {
"match": "2026-07-18-northamptonshire-v-hampshire",
"winner": "Northamptonshire",
"loser": "Hampshire",
"margin": "14 runs"
},
"most_runs": {
"player": "jj-weatherley",
"name": "JJ Weatherley",
"runs": 591
},
"most_wickets": {
"player": "hasan-ali",
"name": "Hasan Ali",
"wickets": 27
}
},
{
"season": "2025",
"slug": "2025",
"matches": 132,
"from": "2025-05-29",
"to": "2025-09-13",
"champion": "Somerset",
"final": {
"match": "2025-09-13-hampshire-v-somerset",
"winner": "Somerset",
"loser": "Hampshire",
"margin": "6 wickets"
},
"most_runs": {
"player": "te-albert",
"name": "TE Albert",
"runs": 633
},
"most_wickets": {
"player": "rp-meredith",
"name": "RP Meredith",
"wickets": 28
}
},
"... 11 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.