Calls

List all calls (unified history)

Unified call history across ALL of your numbers: both channels (WhatsApp Business Calling + regular phone/PSTN), inbound and outbound, newest first. Unlike GET /v1/voice/calls (PSTN-only) and GET /v1/whatsapp/calls (one account at a time), this endpoint needs no accountId and never requires fanning out one request per number.

Any row can be opened channel-agnostically via GET /v1/calls/{id} and GET /v1/calls/{id}/recording; no branching on channel needed. When the counterparty number matches a CRM contact, contactId and contactName are set.

Cursor pagination: pass the returned nextCursor as before to fetch the next page. nextCursor is null on the last page.

Billing: Read (free unless it says otherwise) · Rate limit: 120/min

get/v1/messaging/calls

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/messaging/calls
  • Auth: HTTP bearer

Query parameters

limitinteger
beforestring date-time

Return calls with startedAt strictly before this instant (use the previous page's nextCursor).

numberstring

Exact filter: calls involving this number (typically one of YOUR numbers, to scope history to a single line). E.164, leading + optional.

searchstring

Free-text match on the from/to numbers. Non-digits are stripped, so partial queries like 302 or +1 302 work.

status'ringing' | 'answered' | 'ended' | 'failed'
channel'whatsapp' | 'pstn'
direction'inbound' | 'outbound'

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.