Documentation / Your key
GET /usageFree key, archive on paid
Snooker API: Your key: its plan, calls today, limits, when they reset, and the data window the plan covers
Your key: its plan, calls today, limits, when they reset, and the data window the plan covers.
GEThttps://api.snookerapi.net/v1/usage
Try it
Returns
| Field | Type | What it holds |
|---|---|---|
| plan | string | The key's plan. |
| calls_today | integer | Calls made today (UTC). |
| per_day | integer or null | Calls allowed a day; null for no daily limit. |
| per_minute | integer | Calls allowed a minute. |
| resets_at | string | When today's count starts again (UTC). |
| window | object | The days of data the key reads: from and to. |
Example answer
A real answer, read from the data within the last hour: GET /v1/usage
{
"data": {
"plan": "Free key",
"calls_today": 0,
"per_day": 50,
"per_minute": 30,
"resets_at": "2026-10-29T00:00:00Z",
"window": {
"from": "2026-10-27",
"to": null
}
},
"meta": {
"plan": "Free key"
}
}Errors
| Status | Code | When |
|---|---|---|
| 401 | unauthorized | No key, or a key that is not valid. Errors |
| 400 | bad_request | A parameter has the wrong shape. Errors |
| 422 | unknown_parameter | A parameter this call does not take. Errors |
| 429 | rate_limited | Too many calls this minute; wait for Retry-After. Errors |