Credits

Usage is billed in credit minutes from a balance shared across your whole organization. Calls and interviews both draw from it.

bash

curl "https://api.rabbitt.ai/api/v1/usage" \
  -H "Authorization: Bearer $RABBITT_API_KEY"

json

{
  "object": "usage",
  "organization": { "id": "507f1f77bcf86cd799439099", "name": "Acme", "plan": "starter" },
  "credits": { "allocatedMinutes": 1000, "usedMinutes": 342, "remainingMinutes": 658 },
  "limits": { "maxAgents": 10, "maxUsers": 5, "maxConcurrentCalls": 1 }
}

Settlement is not instant

Minutes are settled shortly after a conversation ends, not while it runs. A balance read during a busy period slightly overstates what you have left. Leave headroom rather than running to zero.

Three separate limits

These are independent, and hitting one tells you nothing about the others.

Credit minutes — how much conversation you have left. Exhausting it returns 402.

maxAgents — how many agents can exist at once. Creating one past the quota returns 409 ORGANIZATION_AGENT_LIMIT.

maxConcurrentCalls — how many calls can be in progress simultaneously. This is the one that most often surprises people: with maxConcurrentCalls: 1, a loop placing ten calls does not run ten conversations, it queues them.

Checking before you spend

For long-running jobs, read GET /v1/usage before starting and stop early rather than discovering an empty balance a few hundred calls in. It costs one request.

BYOK keys are billed differently

See Bring your own key for how BYOK works end to end. Everything above describes credit-minute billing, which is the default. A key created with byok: true does not draw from this balance at all — its calls and interviews run on your own AI provider credentials and are billed per minute instead. GET /v1/usage still reports your organization's shared credit balance; it does not separately reflect BYOK-key usage, since that usage was never charged against it.

Outbound telephony minutes are the one exception: they are carrier cost the platform pays regardless of whose AI provider keys transcribed or generated the conversation, so phone calls still draw from your credit balance even on a BYOK key.