Competitions

Parameters

None: the key alone identifies the request.

Request

curl -H "Authorization: Bearer $CDB_KEY" \
  "https://api.cricketdatabase.com/v1/competitions"

import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions",
                 headers={"Authorization": f"Bearer {key}"})
print(r.json())

const r = await fetch("https://api.cricketdatabase.com/v1/competitions",
  { headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());

curl -H "X-API-Key: $CDB_KEY" \
  "https://api.cricketdatabase.com/v1/competitions"

import requests
r = requests.get("https://api.cricketdatabase.com/v1/competitions",
                 headers={"X-API-Key": key})
print(r.json())

const r = await fetch("https://api.cricketdatabase.com/v1/competitions",
  { headers: { "X-API-Key": key } });
console.log(await r.json());

Response

{
    "data": {
        "total": 1185,
        "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"
            },
            {
                "competition": "county-championship",
                "name": "County Championship",
                "kind": "domestic",
                "gender": "male",
                "country": "England",
                "matches": 1483,
                "first_match": "2014-04-06",
                "latest_match": "2026-09-27"
            },
            "... 1183 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.