WHIZZVOICE
Docs · API · Usage

Usage & credits.

Voice is billed per second after a 10-second minimum, at your language tier's all-in per-minute rate — speech, orchestration, knowledge base, tools and analytics included. Telephony is metered separately at cost. Meter both with GET /v1/usage.

The credit model#

  • 1 credit = 1 US cent. A plan comes with a monthly call credit — Growth is $105 a month, or 10,500 credits — that your minutes draw down as calls run. Past the included credit, overage meters at the same per-minute rate. No seats, no per-token charges.
  • Per second, after a 10-second floor.Every connected call bills a minimum of 10 seconds, then per actual second — a 96-second call bills 96 seconds. The rate is your agent's lang_tier, in credits per minute.
  • Failed calls don't cost voice minutes. A no_answer, busy, or failed call never draws from the voice wallet — only the telephony leg, if the carrier charged for the attempt, is metered.
  • Four language tiers. Lite $0.05, Global $0.09, Extended $0.13, and Arabic $0.15 per minute. An agent that speaks any Arabic bills at the Arabic tier. Volume rates apply on Scale and above — full pricing is on the pricing page.

Your live balance is on the dashboard and in every GET /v1/usageresponse. When the wallet can't cover a call about to start, it fails with 402 insufficient_credits — see Errors.

Usage endpoint#

GET/v1/usage
QueryTypeDescription
daysintegerdefault: 30Reporting window in days, from 1 to 90.
Request
curl "https://voice.whizztech.ai/v1/usage?days=7" \
  -H "Authorization: Bearer $WHIZZ_KEY"
Response · 200 OK
{
  "object": "usage",
  "days": 7,
  "credit_balance": 38120,
  "daily": [
    {
      "day": "2026-07-11",
      "voice_minutes": 398.2,
      "credits": 3318,
      "calls": 271,
      "telephony_usd": 5.94
    },
    {
      "day": "2026-07-12",
      "voice_minutes": 412.5,
      "credits": 3437,
      "calls": 298,
      "telephony_usd": 6.19
    }
  ],
  "totals": {
    "voice_minutes": 810.7,
    "credits": 6755,
    "calls": 569,
    "telephony_usd": 12.13
  }
}

Fields#

FieldTypeDescription
credit_balanceintegerCurrent voice-credit balance across all grants, purchases, debits, and refunds — in credits (1 credit = 1 US cent).
daily[].voice_minutesnumberBilled voice minutes that day, summed across calls (per-second billing rolled up to minutes).
daily[].creditsintegerVoice credits consumed that day — minutes × the agents' per-minute tier rate.
daily[].callsintegerConnected, billed calls that day. Unbilled failures (no_answer / busy) are not counted here.
daily[].telephony_usdnumberTelephony cost that day, in USD — PSTN legs and number rental, metered at cost and billed separately from credits.
totalsobjectThe same four measures summed across the window: { voice_minutes, credits, calls, telephony_usd }.
NextErrors→