Usage

Parameters

None: the key alone identifies the request.

Request

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

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

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

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

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

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

Response

{
    "data": {
        "plan": "plus",
        "plan_name": "Analyst Pro",
        "calls": {
            "today": 0,
            "this_month": 0
        },
        "limits": {
            "per_day": 100000,
            "per_minute": 300,
            "remaining_today": 100000
        },
        "resets": {
            "day": "2026-10-13T00:00:00Z",
            "minute": "2026-10-12T21:43:00Z"
        },
        "key": {
            "prefix": "cdb_live_doc",
            "label": "Documentation",
            "created_at": "2026-10-12T21:42:50Z",
            "last_used_at": null
        }
    },
    "meta": {
        "plan": "plus",
        "window": {
            "from": "2001-12-01",
            "to": "today",
            "ball_by_ball": "every match",
            "analytics": true
        }
    }
}

A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.