Account
Usage
Your current plan, credit balance, calls made this period, and auto-recharge settings. The only GET endpoint in the API and the only one that takes no body. Costs 0 credits, so you can poll it freely.
GET/api/v1/usage
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonRequest
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
usage = client.usage()
print(usage["credit_balance"])Response
"plan": "project",
"credit_balance": 6431,
"purchased_credits": 0,
"searches_used": 569,
"period_start": "2026-07-14T00:00:00.000Z",
"enabled": false,
"threshold": 0,
"amount": 0,
"cost": 0
}
}