Clatter LabsHelp Center

How do I avoid my app stopping when credits run out?

How-toUpdated

When credits reach zero, every call answers 402 out_of_credits, so plan ahead:

  1. Check the balance regularly with GET /v1/account on the Agent API (a key with account:read), or in Console › Billing.
  2. Alert at a threshold you choose, for example a week of normal spend.
  3. Top up in Console › Billing › Credits (any amount from $1 to $800 per purchase; credits don't expire).
  4. Handle 402 gracefully in your app: show a friendly message instead of a crash, and notify your team.

Good to know#

  • If calls fail unexpectedly, check status.clatterlabs.com before debugging further.
  • Your key's account is responsible for your end users' text under the Abuse policy. What it means for apps
  • Every response has an X-Request-Id; log it so a request can be found later. Why log it

Still need help?#

We usually reply within the first hour, and always within 24 hours. A full support team is with you.

Related articles

Still need help?

Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.

Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyz
For deleting your whole account or the data of one service.