API Reference
GET /balance
Returns your current credit balance and account status.
Request
curl https://embed.statode.com/balance -H "X-API-Key: YOUR_KEY"
No request body needed.
Response
| Field | Type | Description |
|---|---|---|
customer | string | Your account identifier |
credits_remaining | float | Available credits |
unlimited | bool | True if your account has unlimited access (no metering) |
{
"customer": "acme-coffee",
"credits_remaining": 4820.5,
"unlimited": false
}
Cost
Free. No credits charged.
Notes
- When
credits_remaininghits zero, API calls return 402 (Payment Required). - Accounts with
unlimited: trueare not metered and will always show a high balance. - Check this endpoint periodically or after large batch operations to monitor usage.