Skip to content
DashboardGet API key

List voice calls

View .md
GET

List voice calls for this project, most recent first. Transcripts are omitted from the list; fetch a single call to get its transcript.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Query parameters

  • statusstring

    Lifecycle status of a voice call. - queued: outbound call created, not yet dialing. - ringing: dialing (outbound) or received and ringing (inbound). - in_progress: answered, the agent is connected. - completed: ended after a conversation. - failed: could not be completed. - busy: the line was busy. - no_answer: rang but was not answered. - canceled: canceled before it was answered.

    One ofqueuedringingin_progresscompletedfailedbusyno_answercanceled
  • directionstring

    Whether the call was placed by Zavu (outbound) or received from a caller (inbound).

    One ofinboundoutbound
  • senderIdstring

    Keep only calls placed or received by this sender.

  • limitinteger
    Default50
    Limitsmax 100
  • cursorstring

Responses

200List of voice calls.
  • itemsobject[]required
    15 properties
    • idstringrequired
    • directionstringrequired

      Whether the call was placed by Zavu (outbound) or received from a caller (inbound).

      One ofinboundoutbound
    • fromstringrequired

      Caller phone number in E.164 format. Your sender's number for outbound calls; the caller's number for inbound calls.

    • tostringrequired

      Callee phone number in E.164 format.

    • statusstringrequired

      Lifecycle status of a voice call. - queued: outbound call created, not yet dialing. - ringing: dialing (outbound) or received and ringing (inbound). - in_progress: answered, the agent is connected. - completed: ended after a conversation. - failed: could not be completed. - busy: the line was busy. - no_answer: rang but was not answered. - canceled: canceled before it was answered.

      One ofqueuedringingin_progresscompletedfailedbusyno_answercanceled
    • endReasonstringnullable

      Why the call ended (e.g. agent_ended, max_duration, transfer, hangup). Present once the call is no longer active.

    • answeredAtstring<date-time>nullable

      When the call was answered.

    • endedAtstring<date-time>nullable

      When the call ended.

    • durationSecondsintegernullable

      Billable talk time in seconds, measured from answer to hangup.

    • turnCountintegernullable

      Number of conversation turns exchanged during the call.

    • transcriptobject[]

      Ordered transcript of the call. Included when retrieving a single call; omitted from list responses.

      5 properties
      • seqintegerrequired

        Ordinal position of the turn within the call, starting at 0.

      • rolestringrequired

        Who produced the turn. tool records a tool call the agent made during the conversation.

        One ofuserassistanttool
      • textstringrequired

        Transcribed speech for user and assistant turns, or a JSON summary of the tool call for tool turns.

      • startedAtstring<date-time>nullable

        When the turn started.

      • endedAtstring<date-time>nullable

        When the turn ended.

    • costnumbernullable

      Total cost of the call in USD, combining the managed voice pipeline per-minute charge, telephony, and, on an agent that runs a premium model, that model's tokens. Available once the call has ended. Tokens are charged between 30 minutes and 24 hours after the call ends, so the figure can grow until then.

    • metadataobject

      Arbitrary metadata you attached when creating the call.

      1 properties
      • {key}string
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>
  • nextCursorstringnullable
400Invalid query parameters: an unknown `status` or `direction`, or a `limit` outside 1-100.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject