WARP guide

Usage and Call Statistics

How to read dashboard usage, call statistics, CDRs, trends, exports, and the relationship between usage and billing.

Call Statistics shows the voice activity behind your operations and billing. Use it to understand call volume, failed calls, answer rates, trends, and exports. Pair it with Billing when you need to reconcile usage to charges.

What You Can See

The Call Statistics page summarizes your call activity for the active customer. Depending on filters and date range, it can show aggregate statistics, detailed call records, and trend data.

Common questions it answers:

  • How many calls did we send or receive?
  • Which calls failed?
  • Did traffic increase during a specific time window?
  • Which trunks or numbers are involved?
  • Can we export records for audit or finance?

If the page is missing or empty, confirm your role has cdrs:read.

Statistics, Details, Trends, and Export

Use the views together:

  • Statistics show the high-level picture: volume, outcomes, and performance.
  • Details show individual call records.
  • Trends show how traffic changes over time.
  • Export gives you a CSV for offline analysis, reconciliation, or support tickets.

Start broad with statistics, narrow down with details, then export when you need evidence.

Reading Failed Calls

For failed calls, collect enough context to separate routing, capacity, and downstream issues:

  • Direction: inbound or outbound.
  • Timestamp with timezone.
  • Calling number and called number.
  • Trunk name.
  • SIP status code if available.
  • Whether the issue was setup, audio, DTMF, or disconnect.

A burst of 503 responses can indicate CPS back-pressure. Calls that never appear in CDRs may not have reached WARP, or they may have been blocked before normal call handling. Calls that appear with unexpected status codes may need trunk or routing review.

Reconciling Usage to Billing

Usage and billing are related but not identical views.

  • Call Statistics shows the activity.
  • The billing ledger shows the account transactions created from usage, payments, credits, and recurring charges.
  • Invoices summarize a billing period.

If an invoice looks high, start with Call Statistics for the period, then compare the ledger entries and invoice. If you contact support, include the invoice ID, date range, exported CDRs if available, and the specific line or charge you are questioning.

Scopes and API Reference

Call statistics require cdrs:read:

  • GET /v1/cdr/statistics
  • GET /v1/cdr/details
  • GET /v1/cdr/trends
  • GET /v1/cdr/export

Dashboard analytics may require analytics:read:

  • GET /v1/dashboard/stats

Billing reconciliation requires billing:read:

  • GET /v1/billing/ledger
  • GET /v1/invoices
  • GET /v1/invoices/:id

When to Ask Buzz

Ask Buzz when you want a quick explanation of a metric, a failed-call pattern, or which records to export. Buzz can help connect a call-statistics question to trunks, numbers, and billing, but it uses your scopes. If you do not have cdrs:read, ask a customer admin to update your role or have someone with access export the records.