## Search

**post** `/call/search`

Retrieve a paginated list of call attempts. Each entry includes the call status, phone number, assistant used, transcript, and timestamps. Use the page and page_size query parameters to navigate through results.

### Body Parameters

- `assignee_ids: array of string`

- `assistant_ids: array of string`

- `campaign_ids: array of string`

- `directions: array of "inbound" or "outbound"`

  - `"inbound"`

  - `"outbound"`

- `from_phone_numbers: array of string`

- `outcomes: array of "not_interested" or "interested" or "completed" or 2 more`

  - `"not_interested"`

  - `"interested"`

  - `"completed"`

  - `"requested_callback_later"`

  - `"none"`

- `page: number`

- `page_size: number`

- `results: array of "IVR" or "voicemail" or "human" or 3 more`

  - `"IVR"`

  - `"voicemail"`

  - `"human"`

  - `"unknown"`

  - `"ios-screening-filter"`

  - `"none"`

- `statuses: array of "initializing" or "queued_for_calling" or "calling" or 6 more`

  - `"initializing"`

  - `"queued_for_calling"`

  - `"calling"`

  - `"post_processing"`

  - `"scheduled"`

  - `"paused"`

  - `"completed"`

  - `"cancelled"`

  - `"errored"`

- `call_ids: optional array of string`

- `query: optional string`

- `sort_by: optional string`

- `sort_direction: optional "asc" or "desc"`

  - `"asc"`

  - `"desc"`

- `to_phone_number: optional string`

### Returns

- `calls: array of object { id, assignee, assistant, 24 more }`

  - `id: string`

    The ID of the call.

  - `assignee: object { id, email, first_name, last_name }`

    The team member responsible for following up on this call.

    - `id: string`

      The database user id of the assignee.

    - `email: string`

    - `first_name: string`

    - `last_name: string`

  - `assistant: object { id, after_call_sms_outcomes, after_call_sms_prompt, 50 more }`

    - `id: string`

    - `after_call_sms_outcomes: array of "not_interested" or "interested" or "completed" or 2 more`

      Which call outcomes trigger the after-call SMS. When empty or null, no after-call SMS is sent. Use "none" when outcome is null.

      - `"not_interested"`

      - `"interested"`

      - `"completed"`

      - `"requested_callback_later"`

      - `"none"`

    - `after_call_sms_prompt: string`

      Prompt / instructions for the after-call SMS. Supports {{variable}} placeholders. When null, no after-call SMS is sent.

    - `background_sound: "audio/office.ogg"`

      Ambient background sound to play during the call. null disables it.

      - `"audio/office.ogg"`

    - `background_sound_volume: number`

      Volume of the ambient background sound (0 = silent, 1 = max).

    - `calendly: object { connection_id, event_type_id }`

      - `connection_id: string`

        The connection ID representing the link between your Calendly account and Revox.

      - `event_type_id: string`

        The event type ID representing the event type to schedule. (eg: https://api.calendly.com/event_types/b2330295-2a91-4a1d-bb73-99e7707663d5)

    - `call_retry_config: object { allowed_days, call_twice_in_a_row, calling_windows, 2 more }`

      Configuration for call retry behavior including time windows, delays, and max iterations. If not provided, defaults will be used.

      - `allowed_days: array of "monday" or "tuesday" or "wednesday" or 4 more`

        Days of the week when calls are allowed, in the recipient's timezone. Default: Monday through Friday.

        - `"monday"`

        - `"tuesday"`

        - `"wednesday"`

        - `"thursday"`

        - `"friday"`

        - `"saturday"`

        - `"sunday"`

      - `call_twice_in_a_row: boolean`

        If true and max_retry_attempts >= 2, attempt #2 fires immediately (skipping retry_delay_seconds) when attempt #1 didn't reach a human. Calling-window/allowed-days checks still apply. Only affects the 1→2 transition. Default: false.

      - `calling_windows: array of object { calling_window_end_time, calling_window_start_time, retry_delay_seconds }`

        - `calling_window_end_time: string`

          End time for the calling window in the recipient's timezone (or timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour). Examples: '17:00', '6pm'. Default: '18:00'.

        - `calling_window_start_time: string`

          Start time for the calling window in the recipient's timezone (or timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour). Examples: '09:00', '10am'. Default: '10:00'.

        - `retry_delay_seconds: number`

          Delay between retry attempts in seconds. 0 retries as soon as the calling window allows. Default: 7200 (2 hours).

      - `max_retry_attempts: number`

        Maximum number of call retry attempts. Default: 3.

      - `timezone: optional string`

        Optional IANA timezone identifier to override the automatic timezone detection from phone number. If not provided, timezone is determined from the recipient's phone number country code. Examples: 'America/New_York', 'Europe/Paris'.

    - `cartesia_dictionary_pronunciation_id: string`

      Optional Cartesia pronunciation dictionary ID linked to this assistant.

    - `created_at: unknown`

    - `custom_tools: array of object { body_template, description, headers, 5 more }`

      - `body_template: string`

        JSON body template for the request. Use quoted {{variable}} placeholders (e.g. "{{name}}") for dynamic values

      - `description: string`

        Human-readable description of what the tool does, used by the LLM to decide when to call it

      - `headers: array of object { key, value }`

        HTTP headers to include in the request. Values support {{variable}} placeholders

        - `key: string`

        - `value: string`

      - `input_schema: array of object { name, required, type, 2 more }`

        Schema defining the parameters the LLM should extract from the conversation to pass to this tool

        - `name: string`

        - `required: boolean`

        - `type: "string" or "number" or "boolean" or 3 more`

          - `"string"`

          - `"number"`

          - `"boolean"`

          - `"enum"`

          - `"date"`

          - `"datetime"`

        - `description: optional string`

        - `enum_options: optional array of string`

      - `method: "GET" or "POST" or "PUT" or 2 more`

        HTTP method to use when calling the API endpoint

        - `"GET"`

        - `"POST"`

        - `"PUT"`

        - `"PATCH"`

        - `"DELETE"`

      - `name: string`

        Unique tool name in lowercase_snake_case (e.g. check_inventory)

      - `query_params: array of object { key, value }`

        Query string parameters appended to the URL. Values support {{variable}} placeholders

        - `key: string`

        - `value: string`

      - `url: string`

        Full URL of the API endpoint. Supports {{variable}} placeholders for dynamic values

    - `email_notification_address: string`

      Email address(es) to receive notifications when a call ends with a matching outcome. Accepts a single email or a comma-separated list (e.g. "alice@x.com, bob@y.com").

    - `email_notification_outcomes: array of "not_interested" or "interested" or "completed" or 2 more`

      Which call outcomes trigger an email notification. E.g. ["interested", "completed", "none"]. Use "none" when outcome is null.

      - `"not_interested"`

      - `"interested"`

      - `"completed"`

      - `"requested_callback_later"`

      - `"none"`

    - `end_of_call_sentence: string`

    - `first_sentence: string`

    - `first_sentence_delay_ms: number`

      Delay in milliseconds before speaking the first sentence. Default: 400.

    - `first_sentence_mode: "generated" or "static" or "none"`

      - `"generated"`

      - `"static"`

      - `"none"`

    - `from_phone_number: string`

      Override the default outbound phone number for calls placed with this assistant. When null, the organization's default phone number is used.

    - `human_transfer_mode: "warm" or "cold"`

      Warm or cold transfer when transfer_destinations is non-empty; null when transfer is not configured.

      - `"warm"`

      - `"cold"`

    - `ivr_navigation_enabled: boolean`

      Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and skip turns to navigate phone menus.

    - `llm_model: object { name, type }  or object { openrouter_model_id, openrouter_provider, type }  or object { api_key, api_url, model_name, type }  or object { provider, realtime_model_id, type, realtime_voice_id }`

      - `UnionMember0 = object { name, type }`

        - `name: "gpt-4.1" or "ministral-3-8b-instruct"`

          - `"gpt-4.1"`

          - `"ministral-3-8b-instruct"`

        - `type: "dedicated-instance"`

          - `"dedicated-instance"`

      - `UnionMember1 = object { openrouter_model_id, openrouter_provider, type }`

        - `openrouter_model_id: string`

          The model ID to use from OpenRouter. eg: openai/gpt-4.1

        - `openrouter_provider: string`

          The provider to use from OpenRouter. eg: nebius, openai, azure, etc.

        - `type: "openrouter"`

          Use a model from OpenRouter.

          - `"openrouter"`

      - `UnionMember2 = object { api_key, api_url, model_name, type }`

        - `api_key: string`

          API key sent as Bearer token to the custom endpoint.

        - `api_url: string`

          Base URL for the OpenAI-compatible API, e.g. https://api.together.xyz/v1

        - `model_name: string`

          Model name as expected by the provider, e.g. meta-llama/llama-3-70b

        - `type: "custom"`

          OpenAI-compatible chat completions API (bring your own endpoint and key).

          - `"custom"`

      - `UnionMember3 = object { provider, realtime_model_id, type, realtime_voice_id }`

        - `provider: "openai" or "google"`

          The provider to use from Realtime. eg: openai, google.

          - `"openai"`

          - `"google"`

        - `realtime_model_id: string`

          The model ID to use from Realtime. eg: gpt-4.1

        - `type: "realtime"`

          Use a model from Realtime.

          - `"realtime"`

        - `realtime_voice_id: optional string`

          Output voice for the realtime provider (e.g. OpenAI: marin; Gemini: Puck).

    - `logo_url: string`

      Public URL of the brand logo shown on the assistant's demo page. Null when unset.

    - `max_call_duration_secs: number`

      The maximum duration of the call in seconds. This is the maximum time the call will be allowed to run.

    - `max_duration_end_message: string`

      Optional message the agent will say, without being interruptible, when the call reaches its max duration. Kept short so it fits inside the farewell buffer. If null, the call ends silently.

    - `name: string`

    - `organization_id: string`

    - `position: object { x, y }`

      - `x: number`

      - `y: number`

    - `precall_lookup_url: string`

      URL fetched before an inbound call is answered to resolve the assistant's prompt variables. Null when no lookup is configured.

    - `prompt: string`

    - `prompt_flow: object { edges, nodes }`

      - `edges: array of object { id, source, target }`

        - `id: string`

        - `source: string`

        - `target: string`

      - `nodes: array of object { id, data, position, type }`

        - `id: string`

        - `data: object { body, title }`

          - `body: string`

          - `title: string`

        - `position: object { x, y }`

          - `x: number`

          - `y: number`

        - `type: "promptBlock"`

          - `"promptBlock"`

    - `slack: object { channels, connection_id, outcomes, template }`

      - `channels: array of object { id, name }`

        The Slack channels eligible to receive the notification. When more than one is configured, the agent prompt may define routing rules to narrow it down per call; with no such rules every channel here is notified.

        - `id: string`

          The Slack channel ID (e.g. 'C01234567').

        - `name: optional string`

          Human-readable Slack channel name, cached for display in the UI and given to the LLM when the agent prompt routes by channel name.

      - `connection_id: string`

        The Nango connection ID linking the org's Slack workspace to Revox.

      - `outcomes: array of "not_interested" or "interested" or "completed" or 2 more`

        Which call outcomes trigger a Slack notification (e.g. ['interested', 'none']). Use 'none' to notify when outcome is null.

        - `"not_interested"`

        - `"interested"`

        - `"completed"`

        - `"requested_callback_later"`

        - `"none"`

      - `template: optional string`

        Optional message template. Supports {{summary}}, {{outcome}}, {{phone}}, {{call_url}}, {{assistant_name}}, {{campaign_name}}, {{first_name}}, {{last_name}}, {{email}}, {{company}}, {{job_title}}, {{contact_name}}, {{contact_line}}, plus prompt_variables and structured_output keys. When null/empty a default template is used.

    - `sms_enabled: boolean`

      Enable SMS tool during calls. When enabled, the agent can send SMS messages to the user on the call.

    - `sms_template: string`

      Hardcoded SMS template to send during calls. When set, this exact text is sent instead of letting the agent generate the message. Supports {{variable}} placeholders.

    - `structured_output_config: array of object { name, required, type, 2 more }`

      The structured output config to use for the call. This is used to extract the data from the call (like email, name, company name, etc.).

      - `name: string`

      - `required: boolean`

      - `type: "string" or "number" or "boolean" or 3 more`

        - `"string"`

        - `"number"`

        - `"boolean"`

        - `"enum"`

        - `"date"`

        - `"datetime"`

      - `description: optional string`

      - `enum_options: optional array of string`

    - `structured_output_prompt: string`

      Custom prompt for structured data extraction. If not provided, a default prompt is used. Available variables: {{transcript}}, {{call_direction}}, {{user_phone_number}}, {{agent_phone_number}}.

    - `stt_context: object { general, terms }`

      Assistant-level speech-to-text context: structured `general` key/value pairs plus a list of domain `terms`. Prompt-derived context is merged in without replacing existing entries.

      - `general: array of object { key, value }`

        - `key: string`

        - `value: string`

      - `terms: array of string`

    - `stt_model: "stt-rt-v4" or "stt-rt-v5"`

      Transcriber (speech-to-text) model used for the assistant.

      - `"stt-rt-v4"`

      - `"stt-rt-v5"`

    - `thinking_sound: "city-ambience.ogg" or "forest-ambience.ogg" or "office-ambience.ogg" or 4 more`

      Audio clip to play while the agent is processing a response. One of the built-in LiveKit audio clips; null disables it.

      - `"city-ambience.ogg"`

      - `"forest-ambience.ogg"`

      - `"office-ambience.ogg"`

      - `"crowded-room.ogg"`

      - `"keyboard-typing.ogg"`

      - `"keyboard-typing2.ogg"`

      - `"hold_music.ogg"`

    - `thinking_sound_probability: number`

      Probability [0..1] that the thinking sound plays on any given turn; otherwise the agent is silent while thinking.

    - `thinking_sound_volume: number`

      Volume of the thinking sound (0 = silent, 1 = max).

    - `transfer_destinations: array of object { label, phone_number }`

      Where calls can be transferred to when users ask to speak to a human. Null or empty when transfer is not configured.

      - `label: string`

      - `phone_number: string`

    - `type: "standalone" or "multi-step" or "sub-assistant"`

      - `"standalone"`

      - `"multi-step"`

      - `"sub-assistant"`

    - `updated_at: unknown`

    - `voice: object { id, provider, model, 2 more }`

      - `id: string`

        The ID of the voice.

      - `provider: "cartesia" or "elevenlabs" or "gradium"`

        The provider of the voice.

        - `"cartesia"`

        - `"elevenlabs"`

        - `"gradium"`

      - `model: optional "sonic-3" or "sonic-3.5"`

        Cartesia TTS model (Cartesia only). Defaults to sonic-3 when omitted. Ignored for other providers.

        - `"sonic-3"`

        - `"sonic-3.5"`

      - `speed: optional number`

        The speed of the voice. Range depends on provider: Cartesia 0.6–1.5, ElevenLabs 0.7–1.2, Gradium 0.6–1.5. Default is 1.0.

      - `volume: optional number`

        Volume of the voice (Cartesia only). 0.5–2.0, default 1.0. Ignored for other providers.

    - `voicemail_message: string`

      If set, when voicemail is detected the agent will speak this message then hang up; if null, hang up immediately.

    - `voicemail_sms_prompt: string`

      Prompt / instructions for the voicemail SMS. Supports {{variable}} placeholders. When null, no SMS is sent on voicemail.

    - `warm_transfer_summary_instructions: string`

      Warm transfer only: instructions for the supervisor handoff summary; null when not configured or cold transfer.

    - `webhook_url: string`

      The webhook URL to call when the call is completed.

    - `zoho: object { connection_id, field_mapping, log_call_activity, 3 more }`

      - `connection_id: string`

        The Nango connection ID linking the org's Zoho CRM account to Revox.

      - `field_mapping: array of object { source, zoho_field }`

        Maps extracted call fields (structured_output / prompt variables) onto Zoho field API names on the upserted record.

        - `source: string`

          Source key to read from the call: a structured_output field name, falling back to a prompt variable of the same name.

        - `zoho_field: string`

          Destination Zoho field API name on the upserted record (e.g. 'Email', 'Company', or a custom 'Budget__c').

      - `log_call_activity: boolean`

        When true, also log the call as a record in Zoho's Calls module (related to the upserted prospect via Who_Id).

      - `module: string`

        Zoho module the prospect record is upserted into (e.g. 'Leads' or 'Contacts').

      - `outcomes: array of "not_interested" or "interested" or "completed" or 2 more`

        Which call outcomes trigger the Zoho push (e.g. ['interested', 'none']). Use 'none' to push when outcome is null.

        - `"not_interested"`

        - `"interested"`

        - `"completed"`

        - `"requested_callback_later"`

        - `"none"`

      - `template: optional string`

        Optional Note body template. Supports {{summary}}, {{outcome}}, {{phone}}, {{call_url}}, {{assistant_name}}, {{campaign_name}}, {{transcript}}, plus prompt_variables and structured_output keys. When null/empty a default note (outcome + summary + auto-listed extracted fields) is used.

    - `created_by: optional object { id, email, first_name, last_name }`

      The user who created the assistant.

      - `id: string`

        The database user id of the creator.

      - `email: string`

      - `first_name: string`

      - `last_name: string`

    - `faq_items: optional array of object { answer, question, id, 2 more }`

      - `answer: string`

      - `question: string`

      - `id: optional string`

      - `needs_human_answer: optional boolean`

      - `source: optional "human" or "ai"`

        - `"human"`

        - `"ai"`

    - `is_inbound_receptionist: optional boolean`

    - `is_realestate_assistant: optional boolean`

    - `pending_faq_count: optional number`

  - `call_attempts: array of object { id, answered_at, dial_error, 18 more }`

    All call attempts for this call order, ordered by most recent first.

    - `id: string`

      The ID of the call attempt.

    - `answered_at: unknown`

      The time the call was answered.

    - `dial_error: "number_non_attributed" or "too_many_calls" or "busy" or 5 more`

      The SIP error that occurred.

      - `"number_non_attributed"`

      - `"too_many_calls"`

      - `"busy"`

      - `"temporarily_unavailable"`

      - `"no_answer"`

      - `"no_international_permission"`

      - `"precondition_failed"`

      - `"non_classified_error"`

    - `ended_at: unknown`

      The time the call ended.

    - `handled_by_ai: boolean`

      Whether the AI agent conducted the conversation on this attempt. False for a silent speed-dial probe (whose agent only detects a human) and for attempts that were never answered.

    - `handled_by_human: boolean`

      Whether a human operator conducted (part of) this attempt — a jump-in takeover or a speed-dial operator connection (both stamp human_takeover_at).

    - `handled_by_user: object { id, email, first_name, last_name }`

      The team member responsible for following up on this call.

      - `id: string`

        The database user id of the assignee.

      - `email: string`

      - `first_name: string`

      - `last_name: string`

    - `phone_number: string`

      The phone number that was called. Formatted in E.164 format. Example: +1234567890

    - `recording_url: string`

      The URL of the audio recording of the call.

    - `result: "IVR" or "voicemail" or "human" or 2 more`

      - `"IVR"`

      - `"voicemail"`

      - `"human"`

      - `"unknown"`

      - `"ios-screening-filter"`

    - `started_at: unknown`

      The time the call started.

    - `status: "queued" or "ringing" or "ongoing" or 2 more`

      The status of the call attempt.

      - `"queued"`

      - `"ringing"`

      - `"ongoing"`

      - `"completed"`

      - `"error"`

    - `assistants_used: optional array of string`

      Assistant node ids entered during this attempt, in traversal order.

    - `email_log: optional array of object { id, created_at, from_address, 3 more }`

      Notification emails sent in connection with the call, ordered oldest first (from/to addresses, subject, sent time).

      - `id: string`

      - `created_at: unknown`

        When the email was sent.

      - `from_address: string`

      - `resend_message_id: string`

      - `subject: string`

      - `to_emails: array of string`

    - `end_reason: optional "client_initiated" or "connection_timeout" or "human_takeover" or 13 more`

      Reason for ending the call when ended_by is 'agent'. E.g. 'tool_end_call', 'voicemail', 'transfer', 'ivr_no_navigate'.

      - `"client_initiated"`

      - `"connection_timeout"`

      - `"human_takeover"`

      - `"ivr_no_navigate"`

      - `"max_duration"`

      - `"participant_removed"`

      - `"tool_end_call"`

      - `"transfer"`

      - `"user_inactive"`

      - `"user_rejected"`

      - `"user_unavailable"`

      - `"voicemail"`

      - `"speed_dial_abandoned"`

      - `"speed_dial_operator_missed"`

      - `"speed_dial_timeout"`

      - `"speed_dial_hangup"`

    - `ended_by: optional "agent" or "user" or "system"`

      Who ended the call: 'agent' (AI agent), 'user' (caller/callee hung up), or 'system' (e.g. max duration limit).

      - `"agent"`

      - `"user"`

      - `"system"`

    - `post_call_transcript: optional array of object { content, role, tool_arguments, 3 more }`

      Higher-quality transcript generated after the call via Soniox async STT. Null until generated or when no recording is available.

      - `content: string`

      - `role: "user" or "assistant" or "human_agent" or "tool"`

        - `"user"`

        - `"assistant"`

        - `"human_agent"`

        - `"tool"`

      - `tool_arguments: optional map[unknown] or string`

        - `UnionMember0 = map[unknown]`

        - `UnionMember1 = string`

      - `tool_is_error: optional boolean`

      - `tool_name: optional string`

      - `tool_output: optional string`

    - `sms_log: optional array of object { id, created_at, message_body, 3 more }`

      Automatic SMS sent after the call (voicemail and after-call), ordered oldest first. The in-call `send_sms` is excluded — it already appears in the transcript as a tool call.

      - `id: string`

      - `created_at: unknown`

        When the SMS was sent.

      - `message_body: string`

      - `to_phone_number: string`

      - `twilio_message_sid: string`

      - `type: "in_call" or "voicemail" or "after_call"`

        - `"in_call"`

        - `"voicemail"`

        - `"after_call"`

    - `speech_events: optional array of object { id, is_real_turn, llm_ttft_ms, 7 more }`

      Per-turn speech segments (VAD-derived) with timing and pipeline latencies, ordered by started_speaking_at_ms. Empty for calls recorded before this was tracked or for realtime sessions that don't emit them.

      - `id: string`

      - `is_real_turn: boolean`

        False when the segment was flagged as noise/blip rather than a meaningful turn.

      - `llm_ttft_ms: number`

        Agent-only: LLM time-to-first-token for the reply, in ms.

      - `speaker: "user" or "agent"`

        Who was speaking during this segment.

        - `"user"`

        - `"agent"`

      - `started_speaking_at_ms: number`

        Milliseconds since session start when speech began.

      - `stopped_speaking_at_ms: number`

        Milliseconds since session start when speech ended. Null when the session ended before the turn closed.

      - `stt_transcription_delay_ms: number`

        User-only: time from end-of-speech to final transcript, in ms.

      - `transcript: string`

        Recognized text for this segment, when available.

      - `tts_ttfb_ms: number`

        Agent-only: TTS time-to-first-audio-byte for the reply, in ms.

      - `was_cut: boolean`

        Agent-only: true when the agent's audio was interrupted (real or auto-resumed). Null on user segments.

    - `structured_output: optional map[unknown]`

      The data extracted from the call, using the structured output config from the parent call object.

    - `transcript: optional array of object { content, role, tool_arguments, 3 more }`

      The live transcript of the call, built in real time.

      - `content: string`

      - `role: "user" or "assistant" or "human_agent" or "tool"`

        - `"user"`

        - `"assistant"`

        - `"human_agent"`

        - `"tool"`

      - `tool_arguments: optional map[unknown] or string`

        - `UnionMember0 = map[unknown]`

        - `UnionMember1 = string`

      - `tool_is_error: optional boolean`

      - `tool_name: optional string`

      - `tool_output: optional string`

  - `call_retry_config: object { allowed_days, call_twice_in_a_row, calling_windows, 2 more }`

    Configuration for call retry behavior including time windows, delays, and max iterations. If not provided, defaults will be used.

    - `allowed_days: array of "monday" or "tuesday" or "wednesday" or 4 more`

      Days of the week when calls are allowed, in the recipient's timezone. Default: Monday through Friday.

      - `"monday"`

      - `"tuesday"`

      - `"wednesday"`

      - `"thursday"`

      - `"friday"`

      - `"saturday"`

      - `"sunday"`

    - `call_twice_in_a_row: boolean`

      If true and max_retry_attempts >= 2, attempt #2 fires immediately (skipping retry_delay_seconds) when attempt #1 didn't reach a human. Calling-window/allowed-days checks still apply. Only affects the 1→2 transition. Default: false.

    - `calling_windows: array of object { calling_window_end_time, calling_window_start_time, retry_delay_seconds }`

      - `calling_window_end_time: string`

        End time for the calling window in the recipient's timezone (or timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour). Examples: '17:00', '6pm'. Default: '18:00'.

      - `calling_window_start_time: string`

        Start time for the calling window in the recipient's timezone (or timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour). Examples: '09:00', '10am'. Default: '10:00'.

      - `retry_delay_seconds: number`

        Delay between retry attempts in seconds. 0 retries as soon as the calling window allows. Default: 7200 (2 hours).

    - `max_retry_attempts: number`

      Maximum number of call retry attempts. Default: 3.

    - `timezone: optional string`

      Optional IANA timezone identifier to override the automatic timezone detection from phone number. If not provided, timezone is determined from the recipient's phone number country code. Examples: 'America/New_York', 'Europe/Paris'.

  - `calls_count: number`

    The number of call attempts made.

  - `campaign: object { id, name }`

    - `id: string`

    - `name: string`

  - `contact: object { company, email, first_name, 2 more }`

    Magic contact variables (prospect identity) extracted from the call's input data and transcript.

    - `company: string`

    - `email: string`

    - `first_name: string`

    - `job_title: string`

    - `last_name: string`

  - `created_at: unknown`

    The time the call order was created.

  - `direction: "inbound" or "outbound"`

    Whether the call is inbound or outbound.

    - `"inbound"`

    - `"outbound"`

  - `first_sentence_delay_ms: number`

    Delay in milliseconds before speaking the first sentence. Default: 400.

  - `from_phone_number: string`

    The phone number that made the call. Formatted in E.164 format. Example: +1234567890

  - `is_cancelled: boolean`

    DEPRECATED: Whether the call has been cancelled. This is derived from `status`. Use `status` instead.

  - `is_completed: boolean`

    DEPRECATED: Whether the call has completed. This is derived from `status`. Use `status` instead.

  - `last_call_attempt: object { id, answered_at, dial_error, 18 more }`

    This represent a single call attempt. A call attempt is a single call made to the phone number.

    - `id: string`

      The ID of the call attempt.

    - `answered_at: unknown`

      The time the call was answered.

    - `dial_error: "number_non_attributed" or "too_many_calls" or "busy" or 5 more`

      The SIP error that occurred.

      - `"number_non_attributed"`

      - `"too_many_calls"`

      - `"busy"`

      - `"temporarily_unavailable"`

      - `"no_answer"`

      - `"no_international_permission"`

      - `"precondition_failed"`

      - `"non_classified_error"`

    - `ended_at: unknown`

      The time the call ended.

    - `handled_by_ai: boolean`

      Whether the AI agent conducted the conversation on this attempt. False for a silent speed-dial probe (whose agent only detects a human) and for attempts that were never answered.

    - `handled_by_human: boolean`

      Whether a human operator conducted (part of) this attempt — a jump-in takeover or a speed-dial operator connection (both stamp human_takeover_at).

    - `handled_by_user: object { id, email, first_name, last_name }`

      The team member responsible for following up on this call.

      - `id: string`

        The database user id of the assignee.

      - `email: string`

      - `first_name: string`

      - `last_name: string`

    - `phone_number: string`

      The phone number that was called. Formatted in E.164 format. Example: +1234567890

    - `recording_url: string`

      The URL of the audio recording of the call.

    - `result: "IVR" or "voicemail" or "human" or 2 more`

      - `"IVR"`

      - `"voicemail"`

      - `"human"`

      - `"unknown"`

      - `"ios-screening-filter"`

    - `started_at: unknown`

      The time the call started.

    - `status: "queued" or "ringing" or "ongoing" or 2 more`

      The status of the call attempt.

      - `"queued"`

      - `"ringing"`

      - `"ongoing"`

      - `"completed"`

      - `"error"`

    - `assistants_used: optional array of string`

      Assistant node ids entered during this attempt, in traversal order.

    - `email_log: optional array of object { id, created_at, from_address, 3 more }`

      Notification emails sent in connection with the call, ordered oldest first (from/to addresses, subject, sent time).

      - `id: string`

      - `created_at: unknown`

        When the email was sent.

      - `from_address: string`

      - `resend_message_id: string`

      - `subject: string`

      - `to_emails: array of string`

    - `end_reason: optional "client_initiated" or "connection_timeout" or "human_takeover" or 13 more`

      Reason for ending the call when ended_by is 'agent'. E.g. 'tool_end_call', 'voicemail', 'transfer', 'ivr_no_navigate'.

      - `"client_initiated"`

      - `"connection_timeout"`

      - `"human_takeover"`

      - `"ivr_no_navigate"`

      - `"max_duration"`

      - `"participant_removed"`

      - `"tool_end_call"`

      - `"transfer"`

      - `"user_inactive"`

      - `"user_rejected"`

      - `"user_unavailable"`

      - `"voicemail"`

      - `"speed_dial_abandoned"`

      - `"speed_dial_operator_missed"`

      - `"speed_dial_timeout"`

      - `"speed_dial_hangup"`

    - `ended_by: optional "agent" or "user" or "system"`

      Who ended the call: 'agent' (AI agent), 'user' (caller/callee hung up), or 'system' (e.g. max duration limit).

      - `"agent"`

      - `"user"`

      - `"system"`

    - `post_call_transcript: optional array of object { content, role, tool_arguments, 3 more }`

      Higher-quality transcript generated after the call via Soniox async STT. Null until generated or when no recording is available.

      - `content: string`

      - `role: "user" or "assistant" or "human_agent" or "tool"`

        - `"user"`

        - `"assistant"`

        - `"human_agent"`

        - `"tool"`

      - `tool_arguments: optional map[unknown] or string`

        - `UnionMember0 = map[unknown]`

        - `UnionMember1 = string`

      - `tool_is_error: optional boolean`

      - `tool_name: optional string`

      - `tool_output: optional string`

    - `sms_log: optional array of object { id, created_at, message_body, 3 more }`

      Automatic SMS sent after the call (voicemail and after-call), ordered oldest first. The in-call `send_sms` is excluded — it already appears in the transcript as a tool call.

      - `id: string`

      - `created_at: unknown`

        When the SMS was sent.

      - `message_body: string`

      - `to_phone_number: string`

      - `twilio_message_sid: string`

      - `type: "in_call" or "voicemail" or "after_call"`

        - `"in_call"`

        - `"voicemail"`

        - `"after_call"`

    - `speech_events: optional array of object { id, is_real_turn, llm_ttft_ms, 7 more }`

      Per-turn speech segments (VAD-derived) with timing and pipeline latencies, ordered by started_speaking_at_ms. Empty for calls recorded before this was tracked or for realtime sessions that don't emit them.

      - `id: string`

      - `is_real_turn: boolean`

        False when the segment was flagged as noise/blip rather than a meaningful turn.

      - `llm_ttft_ms: number`

        Agent-only: LLM time-to-first-token for the reply, in ms.

      - `speaker: "user" or "agent"`

        Who was speaking during this segment.

        - `"user"`

        - `"agent"`

      - `started_speaking_at_ms: number`

        Milliseconds since session start when speech began.

      - `stopped_speaking_at_ms: number`

        Milliseconds since session start when speech ended. Null when the session ended before the turn closed.

      - `stt_transcription_delay_ms: number`

        User-only: time from end-of-speech to final transcript, in ms.

      - `transcript: string`

        Recognized text for this segment, when available.

      - `tts_ttfb_ms: number`

        Agent-only: TTS time-to-first-audio-byte for the reply, in ms.

      - `was_cut: boolean`

        Agent-only: true when the agent's audio was interrupted (real or auto-resumed). Null on user segments.

    - `structured_output: optional map[unknown]`

      The data extracted from the call, using the structured output config from the parent call object.

    - `transcript: optional array of object { content, role, tool_arguments, 3 more }`

      The live transcript of the call, built in real time.

      - `content: string`

      - `role: "user" or "assistant" or "human_agent" or "tool"`

        - `"user"`

        - `"assistant"`

        - `"human_agent"`

        - `"tool"`

      - `tool_arguments: optional map[unknown] or string`

        - `UnionMember0 = map[unknown]`

        - `UnionMember1 = string`

      - `tool_is_error: optional boolean`

      - `tool_name: optional string`

      - `tool_output: optional string`

  - `llm_model: object { name, type }  or object { openrouter_model_id, openrouter_provider, type }  or object { api_key, api_url, model_name, type }  or object { provider, realtime_model_id, type, realtime_voice_id }`

    - `UnionMember0 = object { name, type }`

      - `name: "gpt-4.1" or "ministral-3-8b-instruct"`

        - `"gpt-4.1"`

        - `"ministral-3-8b-instruct"`

      - `type: "dedicated-instance"`

        - `"dedicated-instance"`

    - `UnionMember1 = object { openrouter_model_id, openrouter_provider, type }`

      - `openrouter_model_id: string`

        The model ID to use from OpenRouter. eg: openai/gpt-4.1

      - `openrouter_provider: string`

        The provider to use from OpenRouter. eg: nebius, openai, azure, etc.

      - `type: "openrouter"`

        Use a model from OpenRouter.

        - `"openrouter"`

    - `UnionMember2 = object { api_key, api_url, model_name, type }`

      - `api_key: string`

        API key sent as Bearer token to the custom endpoint.

      - `api_url: string`

        Base URL for the OpenAI-compatible API, e.g. https://api.together.xyz/v1

      - `model_name: string`

        Model name as expected by the provider, e.g. meta-llama/llama-3-70b

      - `type: "custom"`

        OpenAI-compatible chat completions API (bring your own endpoint and key).

        - `"custom"`

    - `UnionMember3 = object { provider, realtime_model_id, type, realtime_voice_id }`

      - `provider: "openai" or "google"`

        The provider to use from Realtime. eg: openai, google.

        - `"openai"`

        - `"google"`

      - `realtime_model_id: string`

        The model ID to use from Realtime. eg: gpt-4.1

      - `type: "realtime"`

        Use a model from Realtime.

        - `"realtime"`

      - `realtime_voice_id: optional string`

        Output voice for the realtime provider (e.g. OpenAI: marin; Gemini: Puck).

  - `metadata: map[string]`

    Metadata stored with the call.

  - `organization_id: string`

    The ID of the organization that owns the call.

  - `prompt_variables: map[string]`

    Variables used to interpolate the prompt.

  - `scheduled_at: unknown`

    The time the call order is scheduled to start.

  - `status: "initializing" or "queued_for_calling" or "calling" or 6 more`

    The status of the call.

    - `"initializing"`

    - `"queued_for_calling"`

    - `"calling"`

    - `"post_processing"`

    - `"scheduled"`

    - `"paused"`

    - `"completed"`

    - `"cancelled"`

    - `"errored"`

  - `to_phone_number: string`

    The phone number that received the call. Formatted in E.164 format. Example: +1234567890

  - `updated_at: unknown`

    The time the call order was last updated (any state change, retry, or analysis result).

  - `follow_up_emails: optional array of string`

    Extra notification recipients resolved from the agent prompt's own routing rules, when it defines any. Added to the assistant's configured notification recipients; never replaces them. Null when the prompt defines no routing rules.

  - `outcome: optional "not_interested" or "interested" or "completed" or "requested_callback_later"`

    Business outcome of the call. Null if not computed or no transcript.

    - `"not_interested"`

    - `"interested"`

    - `"completed"`

    - `"requested_callback_later"`

  - `outcome_summary: optional string`

    LLM explanation for the outcome, when outcome was computed from the transcript.

  - `slack_channel_ids: optional array of string`

    Slack channels resolved from the agent prompt's own routing rules, when it defines any. Always a subset of the channels configured on the assistant. Null when the prompt defines no routing rules, in which case every configured channel is notified.

- `total_count: number`

### Example

```http
curl https://www.getrevox.com/api/call/search \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $REVOX_API_KEY" \
    -d '{
          "assignee_ids": [
            "string"
          ],
          "assistant_ids": [
            "string"
          ],
          "campaign_ids": [
            "string"
          ],
          "directions": [
            "inbound"
          ],
          "from_phone_numbers": [
            "string"
          ],
          "outcomes": [
            "not_interested"
          ],
          "page": 1,
          "page_size": 1,
          "results": [
            "IVR"
          ],
          "statuses": [
            "initializing"
          ]
        }'
```