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

FieldTypeDescription
customerstringYour account identifier
credits_remainingfloatAvailable credits
unlimitedboolTrue 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_remaining hits zero, API calls return 402 (Payment Required).
  • Accounts with unlimited: true are not metered and will always show a high balance.
  • Check this endpoint periodically or after large batch operations to monitor usage.