Skip to content
First requestVisit website ↗
Navigation

Inbound calls per dialed number and number label

Inbound calls grouped by the workspace number that was dialed and that number's label (Settings → Contact Center → Inbound numbers). Counts calls the platform recorded: team or built-in Voice AI calls by Twilio call ID, and Voice AI provider calls by provider call ID. Integration-reported rows without a verifiable call ID are returned separately as unverified and are never added to calls. A label stamped when the call came in is kept; other calls use the number's current label. Workspace admins and owners only; agents receive 403. Reads pre-computed facts refreshed every 2 hours (7:45 AM–9:45 PM ET) and nightly. verifiedBookings counts non-deleted appointments with an exact saved call ID, grouped by inbound call time. Reschedules count once; later cancellations remain included. Bookings without an exact link are excluded. No conversion rate is inferred.

GET
https://api.channelautomation.com/api/analytics/inbound-calls-by-number

Query parameters

  • workspace_id
    optional
    string
  • fromDate
    optional
    string

    Inclusive start instant (viewer-local day start, ISO 8601).

    format: date-time
  • toDate
    optional
    string

    Exclusive end instant (ISO 8601). Range up to 400 days.

    format: date-time

Returns

200

{ success, data }. data.available=false with a reason when the report is not deployed or temporarily unavailable. Otherwise data has totals, byNumber[], byLabel[], unknownNumber, numbersWithNoCalls[], numbersRoutedElsewhere, labeledNumbersRoutedElsewhere and lastRefreshedAt. verifiedBookingsAvailable is false before the first booking-aware refresh; booking values are then null. When true, totals, each line/label row and unknownNumber include verifiedBookings.

400

Missing workspace or invalid date range.

401

Authentication required
JSON
  • error
    optional
    string
  • success
    optional
    boolean

403

Not a workspace admin or owner, or a different workspace was requested.

Type to search…

↑↓ navigate↵ selectEsc close