Platform

Pricing and billing

Calls are paid for from your workspace’s balance, by the second. There is nothing to pay per request: only time on a call with a caller costs anything.

What a call costs

Every agent has a per-minute rate, its costPerMinute. A call is charged for exactly as long as it lasted, counted from the moment the caller joined:

The sum
cost = durationSeconds ÷ 60 × costPerMinute

The current rate and the plans are on the pricing page, and served by Get the price list, which needs no key. A call keeps the rate it started at, even if the price changes while it runs.

  • The time before the caller joins is not charged.
  • A call nobody joined, and a call that failed to start, cost nothing.
  • Test calls made in the studio are charged like any other call.

The charge is on the call as callCost once it has ended, and arrives with the call.ended webhook.

Balance

Your balance is credit in US dollars. It goes up when a plan is paid for or you add credit in the studio under Billing, and down as calls end. Read it at any time:

curl "https://goblins-call-api.onrender.com/v1/me" \
  -H "Authorization: Bearer $CRACKLE_API_KEY"

List balance history is the ledger behind that number: one entry per charged call, with its duration and rate, and one per credit.

When the balance runs out

Before a call402

With a balance of zero or less, Start a call answers 402 INSUFFICIENT_BALANCE, and the response carries the balance.

During a callmax-duration

A call is given only as long as the balance can pay for. When that time is up it ends with the reason max-duration, so a workspace never goes into debt.

If calls matter to your product, watch the balance from your own monitoring and top up before it gets low.

Plans

A plan adds call credit to the balance each time it is paid for, and sets how many calls the workspace can run at once: see Rate limits and concurrency. Get plan and payments returns the plan a workspace is on.