Docs
API Reference

GET /balance

Returns your remaining quota for the current billing period and your account status.

Request

curl https://dish-embed.latimal.com/balance -H "X-API-Key: YOUR_KEY"

No request body needed.

Response

FieldTypeDescription
customerstringYour account identifier
credits_remainingfloatRemaining quota for the current billing period
unlimitedboolTrue if your account has unlimited access (no metering)
{
  "customer": "acme-coffee",
  "credits_remaining": 4820.5,
  "unlimited": false
}

Availability

Free to call on every plan. This request is not metered and does not count against your monthly quota.

Notes

  • When your quota is exhausted (credits_remaining reaches zero), API calls return 402 (Payment Required), with no overage billing.
  • 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.