// API key usage
Your usage
Free key and every plan
Your plan, calls today, the limits, when they reset and how far back your results reach. Never counted against your allowance.
GEThttps://api.handballapi.com/v1/usage
Try itruns against the live API with your key
keyGet a free key
Kept in this browser and filled in on every docs page. A key made in your account appears here by itself.
Returns9 fields
| field | type | what it holds |
|---|---|---|
plan | string | Your plan's key. |
plan_name | string | Your plan's name. |
calls_today | integer | Calls counted today (UTC). |
calls_this_month | integer | Calls counted this month. |
per_day | integer|null | Your daily allowance, or null for none. |
per_minute | integer|null | Requests a minute, or null for none. |
resets_at | datetime | When the day's allowance resets. |
results_from | date|null | The earliest date your plan reaches, or null for the whole archive. |
all_endpoints | boolean | Whether every endpoint is open to you. |
Example answerGET /v1/usage
200one record
{
"data": {
"plan": "free",
"plan_name": "Free key",
"calls_today": 12,
"calls_this_month": 214,
"per_day": 50,
"per_minute": 10,
"resets_at": "2026-11-01T00:00:00Z",
"results_from": "2026-10-30",
"all_endpoints": false
},
"meta": {
"took_ms": 2
}
}