Competition
GET
/v1/competitions/{competition}On each planFree keyIn fullMatch WeekIn fullArchiveIn fullProIn fullAnalyst ProIn fullMCP toolcompetition
A competition: the names it was filed under, titles by team and all-time leaders.
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"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions/t20-blast",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/competitions/t20-blast",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/competitions/t20-blast"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions/t20-blast",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/competitions/t20-blast",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"competition": "t20-blast",
"name": "T20 Blast",
"kind": "domestic",
"gender": "male",
"country": "England",
"matches": 1570,
"first_match": "2014-05-16",
"latest_match": "2026-07-18",
"also_filed_as": [
"Vitality Blast",
"NatWest T20 Blast",
"... 1 more"
],
"titles": {
"Northamptonshire": 2,
"Somerset": 2,
"Nottinghamshire": 2,
"Gloucestershire": 1,
"Hampshire": 1,
"Kent": 1,
"Essex": 1,
"Worcestershire": 1,
"Lancashire": 1,
"Warwickshire": 1
},
"most_runs": [
{
"player": "jm-vince",
"name": "JM Vince",
"runs": 5547,
"innings": 166,
"hundreds": 6
},
{
"player": "dj-bell-drummond",
"name": "DJ Bell-Drummond",
"runs": 4702,
"innings": 160,
"hundreds": 3
},
"... 6 more"
],
"most_wickets": [
{
"player": "dr-briggs",
"name": "DR Briggs",
"wickets": 206,
"economy": 7.54
},
{
"player": "cp-wood",
"name": "CP Wood",
"wickets": 182,
"economy": 8.21
},
"... 6 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.