Usage
FreeYour plan, lookups used today and what is left. Free to call; it does not count.
Parameters
None.
What each plan returns
Free key
Included.
Archive
Included.
Live
Included.
Response fields
| Field | Meaning |
|---|---|
plan | free, archive or live |
calls_today | Lookups counted today across your keys |
limit, remaining | Your daily allowance and what is left |
resets_utc | When the count resets |
Errors you can get
| Status | Code | When |
|---|---|---|
400 | key_in_address | The key was put in the address. Send it in a header (see Authentication). |
401 | missing_key | No Authorization: Bearer header, or the key was rotated (invalid_key, revoked_key). |
Every error has the same shape. All error codes
Try it live
Runs this call from your browser with your own key and shows what comes back.
curl https://api.rugbyapi.com/v1/usage \
-H "Authorization: Bearer YOUR_KEY"$ch = curl_init('https://api.rugbyapi.com/v1/usage'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_KEY'], CURLOPT_RETURNTRANSFER => true, ]); $data = json_decode(curl_exec($ch), true);
import requests r = requests.get( "https://api.rugbyapi.com/v1/usage", headers={"Authorization": "Bearer YOUR_KEY"}, ) data = r.json()
const r = await fetch('https://api.rugbyapi.com/v1/usage', { headers: { Authorization: 'Bearer YOUR_KEY' } }); const data = await r.json();
EXResponseExample response
{
"plan": "free",
"calls_today": 42,
"limit": 50,
"remaining": 8,
"resets_utc": "2026-09-24T00:00:00Z"
}