How do ClearRun credits work?

Credits pay for hosted scoring. Each score, evaluate or chat call uses credits. Looking up a past verdict is free. The pricing page always has the current cost of each call.

Last updated

What uses credits

  • POST /api/score, POST /api/evaluate and POST /api/chat: yes.
  • The same calls from the SDK, the CLI and the MCP server: yes.
  • GET /api/verify/{id}, a lookup: no.
  • SDK mock mode: no. It never calls ClearRun.

A free account gets 30 credits a month. They don't roll over. Evaluate and score cost at least 3 credits. A chat turn costs at most 4 credits. A free developer key spends the same credits. On the web app, Paste Check and chat spend them too.

When you run out

The API returns HTTP 402 with Insufficient credits. The reply can include how many credits the call needed and your balance. Paid plans come in monthly credit tiers. If you need more credits, move up a tier on the billing page.

You are not charged when a call fails with PERSIST_FAILED. You are not charged for a queued receipt unless and until it is saved. Once it is saved, the call is charged, because the score was made. See Common ClearRun errors.

Invoices

Each subscription charge creates a Stripe invoice. Open the billing page, then the Stripe Customer Portal, to see them. Each paid call is listed in Usage history on the billing page, with a CSV download. See How do I see my ClearRun usage history?