# Call

## Retrieve

`call.retrieve(strid)  -> CallRetrieveResponse`

**get** `/call/{id}`

Retrieve the full details of a call order by its unique ID. The response includes the call status, call attempts, transcript, recording URL, timestamps, and metadata. Use this endpoint to poll for call completion or inspect results after a call has finished.

### Parameters

- `id: str`

### Returns

- `class CallRetrieveResponse: …`

  - `call: Call`

    This represent a call "order" that was requested by the user. A call order can be resolved over multiple call attempts spanning up to a few days.

    - `id: str`

      The ID of the call.

    - `assistant: Optional[CallAssistant]`

      - `id: str`

      - `background_sound: Optional[Literal["audio/office.ogg"]]`

        The background sound to play during the call. Useful to give the impression that your AI agent is in an office.

        - `"audio/office.ogg"`

      - `calendly: Optional[CallAssistantCalendly]`

        - `connection_id: str`

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

        - `event_type_id: str`

          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: Optional[CallAssistantCallRetryConfig]`

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

        - `calling_windows: List[CallAssistantCallRetryConfigCallingWindow]`

          - `calling_window_end_time: str`

            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: str`

            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: int`

            Delay between retry attempts in seconds. Default: 7200 (2 hours).

        - `max_retry_attempts: int`

          Maximum number of call retry attempts. Default: 3.

        - `timezone: Optional[str]`

          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'.

      - `created_at: object`

      - `end_of_call_sentence: Optional[str]`

      - `first_sentence: Optional[str]`

      - `first_sentence_delay_ms: int`

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

      - `first_sentence_mode: Literal["generated", "static", "none"]`

        - `"generated"`

        - `"static"`

        - `"none"`

      - `ivr_navigation_enabled: bool`

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

      - `llm_model: CallAssistantLlmModel`

        - `class CallAssistantLlmModelUnionMember0: …`

          - `name: Literal["gpt-4.1", "ministral-3-8b-instruct"]`

            - `"gpt-4.1"`

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

          - `type: Literal["dedicated-instance"]`

            - `"dedicated-instance"`

        - `class CallAssistantLlmModelUnionMember1: …`

          - `openrouter_model_id: str`

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

          - `openrouter_provider: str`

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

          - `type: Literal["openrouter"]`

            Use a model from OpenRouter.

            - `"openrouter"`

      - `max_call_duration_secs: float`

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

      - `name: str`

      - `organization_id: str`

      - `prompt: str`

      - `structured_output_config: Optional[List[CallAssistantStructuredOutputConfig]]`

        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: str`

        - `required: bool`

        - `type: Literal["string", "number", "boolean", 3 more]`

          - `"string"`

          - `"number"`

          - `"boolean"`

          - `"enum"`

          - `"date"`

          - `"datetime"`

        - `description: Optional[str]`

        - `enum_options: Optional[List[str]]`

      - `transfer_phone_number: Optional[str]`

        Phone number to transfer calls to when users request to speak to a human agent.

      - `updated_at: object`

      - `voice: Optional[CallAssistantVoice]`

        - `id: str`

          The ID of the voice.

        - `provider: Literal["cartesia", "elevenlabs"]`

          The provider of the voice.

          - `"cartesia"`

          - `"elevenlabs"`

        - `speed: Optional[float]`

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

      - `voicemail_message: Optional[str]`

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

      - `webhook_url: Optional[str]`

        The webhook URL to call when the call is completed.

      - `faq_items: Optional[List[CallAssistantFaqItem]]`

        - `answer: str`

        - `question: str`

        - `id: Optional[str]`

        - `needs_human_answer: Optional[bool]`

        - `source: Optional[Literal["human", "ai"]]`

          - `"human"`

          - `"ai"`

      - `pending_faq_count: Optional[float]`

    - `call_attempts: List[CallCallAttempt]`

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

      - `id: str`

        The ID of the call attempt.

      - `answered_at: object`

        The time the call was answered.

      - `dial_error: Optional[Literal["number_non_attributed", "too_many_calls", "busy", 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: object`

        The time the call ended.

      - `phone_number: str`

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

      - `recording_url: Optional[str]`

        The URL of the audio recording of the call.

      - `result: Optional[Literal["IVR", "voicemail", "human", 2 more]]`

        - `"IVR"`

        - `"voicemail"`

        - `"human"`

        - `"unknown"`

        - `"ios-screening-filter"`

      - `started_at: object`

        The time the call started.

      - `status: Literal["queued", "ringing", "ongoing", 2 more]`

        The status of the call attempt.

        - `"queued"`

        - `"ringing"`

        - `"ongoing"`

        - `"completed"`

        - `"error"`

      - `end_reason: Optional[str]`

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

      - `ended_by: Optional[Literal["agent", "user", "system"]]`

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

        - `"agent"`

        - `"user"`

        - `"system"`

      - `structured_output: Optional[Dict[str, object]]`

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

      - `transcript: Optional[List[CallCallAttemptTranscript]]`

        The transcript of the call.

        - `content: str`

        - `role: Literal["user", "assistant", "tool"]`

          - `"user"`

          - `"assistant"`

          - `"tool"`

        - `tool_arguments: Optional[Union[Dict[str, object], str, null]]`

          - `Dict[str, object]`

          - `str`

        - `tool_is_error: Optional[bool]`

        - `tool_name: Optional[str]`

    - `call_retry_config: Optional[CallCallRetryConfig]`

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

      - `calling_windows: List[CallCallRetryConfigCallingWindow]`

        - `calling_window_end_time: str`

          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: str`

          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: int`

          Delay between retry attempts in seconds. Default: 7200 (2 hours).

      - `max_retry_attempts: int`

        Maximum number of call retry attempts. Default: 3.

      - `timezone: Optional[str]`

        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: float`

      The number of call attempts made.

    - `campaign: Optional[CallCampaign]`

      - `id: str`

      - `name: str`

    - `created_at: object`

      The time the call order was created.

    - `direction: Literal["inbound", "outbound"]`

      Whether the call is inbound or outbound.

      - `"inbound"`

      - `"outbound"`

    - `first_sentence_delay_ms: int`

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

    - `from_phone_number: str`

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

    - `is_cancelled: bool`

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

    - `is_completed: bool`

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

    - `last_call_attempt: Optional[CallLastCallAttempt]`

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

      - `id: str`

        The ID of the call attempt.

      - `answered_at: object`

        The time the call was answered.

      - `dial_error: Optional[Literal["number_non_attributed", "too_many_calls", "busy", 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: object`

        The time the call ended.

      - `phone_number: str`

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

      - `recording_url: Optional[str]`

        The URL of the audio recording of the call.

      - `result: Optional[Literal["IVR", "voicemail", "human", 2 more]]`

        - `"IVR"`

        - `"voicemail"`

        - `"human"`

        - `"unknown"`

        - `"ios-screening-filter"`

      - `started_at: object`

        The time the call started.

      - `status: Literal["queued", "ringing", "ongoing", 2 more]`

        The status of the call attempt.

        - `"queued"`

        - `"ringing"`

        - `"ongoing"`

        - `"completed"`

        - `"error"`

      - `end_reason: Optional[str]`

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

      - `ended_by: Optional[Literal["agent", "user", "system"]]`

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

        - `"agent"`

        - `"user"`

        - `"system"`

      - `structured_output: Optional[Dict[str, object]]`

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

      - `transcript: Optional[List[CallLastCallAttemptTranscript]]`

        The transcript of the call.

        - `content: str`

        - `role: Literal["user", "assistant", "tool"]`

          - `"user"`

          - `"assistant"`

          - `"tool"`

        - `tool_arguments: Optional[Union[Dict[str, object], str, null]]`

          - `Dict[str, object]`

          - `str`

        - `tool_is_error: Optional[bool]`

        - `tool_name: Optional[str]`

    - `llm_model: CallLlmModel`

      - `class CallLlmModelUnionMember0: …`

        - `name: Literal["gpt-4.1", "ministral-3-8b-instruct"]`

          - `"gpt-4.1"`

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

        - `type: Literal["dedicated-instance"]`

          - `"dedicated-instance"`

      - `class CallLlmModelUnionMember1: …`

        - `openrouter_model_id: str`

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

        - `openrouter_provider: str`

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

        - `type: Literal["openrouter"]`

          Use a model from OpenRouter.

          - `"openrouter"`

    - `metadata: Optional[Dict[str, str]]`

      Metadata stored with the call.

    - `organization_id: str`

      The ID of the organization that owns the call.

    - `scheduled_at: object`

      The time the call order is scheduled to start.

    - `status: Literal["initializing", "queued_for_calling", "calling", 4 more]`

      The status of the call.

      - `"initializing"`

      - `"queued_for_calling"`

      - `"calling"`

      - `"scheduled"`

      - `"completed"`

      - `"cancelled"`

      - `"errored"`

    - `to_phone_number: str`

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

### Example

```python
import os
from revox import Revox

client = Revox(
    api_key=os.environ.get("REVOX_API_KEY"),  # This is the default and can be omitted
)
call = client.call.retrieve(
    "id",
)
print(call.call)
```

## Create

`call.create(CallCreateParams**kwargs)  -> CallCreateResponse`

**post** `/call`

Place a new outbound call order. Provide either an existing assistant ID or a custom assistant configuration. The call can be scheduled for a specific time or started immediately. A single call order may be resolved over multiple call attempts spanning up to a few days, with automatic retries when voicemail is detected. You can also set concurrency limits and pass prompt variables for dynamic personalization.

### Parameters

- `phone_number: str`

  The phone number to call in the E.164 format. Example: +1234567890

- `assistant: Optional[Assistant]`

  You can provide a custom assistant configuration here. If you don't provide an assistant_id, this assistant object will be used for this call.

  - `prompt: str`

    The prompt to use for the call. This will be given to the LLM (gpt-4.1)

  - `background_sound: Optional[Literal["audio/office.ogg"]]`

    The background sound to play during the call. Useful to give the impression that your AI agent is in an office, in the street, or anywhere else you want.

    - `"audio/office.ogg"`

  - `calendly: Optional[AssistantCalendly]`

    - `connection_id: str`

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

    - `event_type_id: str`

      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: Optional[AssistantCallRetryConfig]`

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

    - `calling_windows: Iterable[AssistantCallRetryConfigCallingWindow]`

      - `calling_window_end_time: str`

        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: str`

        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: int`

        Delay between retry attempts in seconds. Default: 7200 (2 hours).

    - `max_retry_attempts: int`

      Maximum number of call retry attempts. Default: 3.

    - `timezone: Optional[str]`

      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'.

  - `end_of_call_sentence: Optional[str]`

    Optional message to say when the agent decides to end the call.

  - `faq_items: Optional[Iterable[AssistantFaqItem]]`

    FAQ items to associate with this assistant. When provided, replaces all existing FAQ items.

    - `answer: str`

    - `question: str`

  - `first_sentence: Optional[str]`

    The first sentence to use for the call. This will be given to the LLM

  - `first_sentence_delay_ms: Optional[int]`

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

  - `first_sentence_mode: Optional[Literal["generated", "static", "none"]]`

    How the first sentence should be handled. "generated" means the LLM will generate a response based on the first_sentence instruction. "static" means the first_sentence will be spoken exactly as provided. "none" means the agent will not speak first and will wait for the user.

    - `"generated"`

    - `"static"`

    - `"none"`

  - `ivr_navigation_enabled: Optional[bool]`

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

  - `llm_model: Optional[AssistantLlmModel]`

    - `class AssistantLlmModelUnionMember0: …`

      - `name: Literal["gpt-4.1", "ministral-3-8b-instruct"]`

        - `"gpt-4.1"`

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

      - `type: Literal["dedicated-instance"]`

        - `"dedicated-instance"`

    - `class AssistantLlmModelUnionMember1: …`

      - `openrouter_model_id: str`

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

      - `openrouter_provider: str`

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

      - `type: Literal["openrouter"]`

        Use a model from OpenRouter.

        - `"openrouter"`

  - `max_call_duration_secs: Optional[float]`

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

  - `structured_output_config: Optional[Iterable[AssistantStructuredOutputConfig]]`

    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: str`

    - `required: bool`

    - `type: Literal["string", "number", "boolean", 3 more]`

      - `"string"`

      - `"number"`

      - `"boolean"`

      - `"enum"`

      - `"date"`

      - `"datetime"`

    - `description: Optional[str]`

    - `enum_options: Optional[SequenceNotStr[str]]`

  - `transfer_phone_number: Optional[str]`

    Phone number to transfer calls to when users request to speak to a human agent in E.164 format (e.g. +1234567890).

  - `voice: Optional[AssistantVoice]`

    The voice to use for the call. You can get the list of voices using the /voices endpoint

    - `id: str`

      The ID of the voice.

    - `provider: Literal["cartesia", "elevenlabs"]`

      The provider of the voice.

      - `"cartesia"`

      - `"elevenlabs"`

    - `speed: Optional[float]`

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

  - `voicemail_message: Optional[str]`

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

  - `webhook_url: Optional[str]`

    The webhook URL to call when the call is completed.

- `assistant_id: Optional[str]`

  The ID of the assistant to use for this call.

- `concurrency: Optional[Concurrency]`

  Limit the number of concurrent calls for a given concurrency key.

  - `key: str`

    The key for which you want to limit the number of concurrent calls.

  - `max: float`

    The maximum number of concurrent calls to allow for the given concurrency key.

- `force_now: Optional[bool]`

  The prompt to use for the call. This will be given to the LLM (gpt-4.1)

- `from_phone_number: Optional[str]`

  The phone number to use for making the call (e.g., +1234567890). If not provided, uses the default trunk.

- `metadata: Optional[Dict[str, str]]`

  Metadata to store with the call.

- `prompt_variables: Optional[Dict[str, str]]`

  Variables to interpolate into the prompt. Wether you use an assistant_id or an assistant object, this will be used to interpolate the variables into the prompt.

- `scheduled_at: Optional[Union[Union[str, datetime], object]]`

  Schedule the call to start at a specific date and time (ISO 8601 format). If not provided, the call will start immediately.

  - `Union[str, datetime]`

  - `object`

### Returns

- `class CallCreateResponse: …`

  - `call: Call`

    This represent a call "order" that was requested by the user. A call order can be resolved over multiple call attempts spanning up to a few days.

    - `id: str`

      The ID of the call.

    - `assistant: Optional[CallAssistant]`

      - `id: str`

      - `background_sound: Optional[Literal["audio/office.ogg"]]`

        The background sound to play during the call. Useful to give the impression that your AI agent is in an office.

        - `"audio/office.ogg"`

      - `calendly: Optional[CallAssistantCalendly]`

        - `connection_id: str`

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

        - `event_type_id: str`

          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: Optional[CallAssistantCallRetryConfig]`

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

        - `calling_windows: List[CallAssistantCallRetryConfigCallingWindow]`

          - `calling_window_end_time: str`

            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: str`

            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: int`

            Delay between retry attempts in seconds. Default: 7200 (2 hours).

        - `max_retry_attempts: int`

          Maximum number of call retry attempts. Default: 3.

        - `timezone: Optional[str]`

          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'.

      - `created_at: object`

      - `end_of_call_sentence: Optional[str]`

      - `first_sentence: Optional[str]`

      - `first_sentence_delay_ms: int`

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

      - `first_sentence_mode: Literal["generated", "static", "none"]`

        - `"generated"`

        - `"static"`

        - `"none"`

      - `ivr_navigation_enabled: bool`

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

      - `llm_model: CallAssistantLlmModel`

        - `class CallAssistantLlmModelUnionMember0: …`

          - `name: Literal["gpt-4.1", "ministral-3-8b-instruct"]`

            - `"gpt-4.1"`

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

          - `type: Literal["dedicated-instance"]`

            - `"dedicated-instance"`

        - `class CallAssistantLlmModelUnionMember1: …`

          - `openrouter_model_id: str`

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

          - `openrouter_provider: str`

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

          - `type: Literal["openrouter"]`

            Use a model from OpenRouter.

            - `"openrouter"`

      - `max_call_duration_secs: float`

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

      - `name: str`

      - `organization_id: str`

      - `prompt: str`

      - `structured_output_config: Optional[List[CallAssistantStructuredOutputConfig]]`

        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: str`

        - `required: bool`

        - `type: Literal["string", "number", "boolean", 3 more]`

          - `"string"`

          - `"number"`

          - `"boolean"`

          - `"enum"`

          - `"date"`

          - `"datetime"`

        - `description: Optional[str]`

        - `enum_options: Optional[List[str]]`

      - `transfer_phone_number: Optional[str]`

        Phone number to transfer calls to when users request to speak to a human agent.

      - `updated_at: object`

      - `voice: Optional[CallAssistantVoice]`

        - `id: str`

          The ID of the voice.

        - `provider: Literal["cartesia", "elevenlabs"]`

          The provider of the voice.

          - `"cartesia"`

          - `"elevenlabs"`

        - `speed: Optional[float]`

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

      - `voicemail_message: Optional[str]`

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

      - `webhook_url: Optional[str]`

        The webhook URL to call when the call is completed.

      - `faq_items: Optional[List[CallAssistantFaqItem]]`

        - `answer: str`

        - `question: str`

        - `id: Optional[str]`

        - `needs_human_answer: Optional[bool]`

        - `source: Optional[Literal["human", "ai"]]`

          - `"human"`

          - `"ai"`

      - `pending_faq_count: Optional[float]`

    - `call_attempts: List[CallCallAttempt]`

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

      - `id: str`

        The ID of the call attempt.

      - `answered_at: object`

        The time the call was answered.

      - `dial_error: Optional[Literal["number_non_attributed", "too_many_calls", "busy", 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: object`

        The time the call ended.

      - `phone_number: str`

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

      - `recording_url: Optional[str]`

        The URL of the audio recording of the call.

      - `result: Optional[Literal["IVR", "voicemail", "human", 2 more]]`

        - `"IVR"`

        - `"voicemail"`

        - `"human"`

        - `"unknown"`

        - `"ios-screening-filter"`

      - `started_at: object`

        The time the call started.

      - `status: Literal["queued", "ringing", "ongoing", 2 more]`

        The status of the call attempt.

        - `"queued"`

        - `"ringing"`

        - `"ongoing"`

        - `"completed"`

        - `"error"`

      - `end_reason: Optional[str]`

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

      - `ended_by: Optional[Literal["agent", "user", "system"]]`

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

        - `"agent"`

        - `"user"`

        - `"system"`

      - `structured_output: Optional[Dict[str, object]]`

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

      - `transcript: Optional[List[CallCallAttemptTranscript]]`

        The transcript of the call.

        - `content: str`

        - `role: Literal["user", "assistant", "tool"]`

          - `"user"`

          - `"assistant"`

          - `"tool"`

        - `tool_arguments: Optional[Union[Dict[str, object], str, null]]`

          - `Dict[str, object]`

          - `str`

        - `tool_is_error: Optional[bool]`

        - `tool_name: Optional[str]`

    - `call_retry_config: Optional[CallCallRetryConfig]`

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

      - `calling_windows: List[CallCallRetryConfigCallingWindow]`

        - `calling_window_end_time: str`

          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: str`

          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: int`

          Delay between retry attempts in seconds. Default: 7200 (2 hours).

      - `max_retry_attempts: int`

        Maximum number of call retry attempts. Default: 3.

      - `timezone: Optional[str]`

        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: float`

      The number of call attempts made.

    - `campaign: Optional[CallCampaign]`

      - `id: str`

      - `name: str`

    - `created_at: object`

      The time the call order was created.

    - `direction: Literal["inbound", "outbound"]`

      Whether the call is inbound or outbound.

      - `"inbound"`

      - `"outbound"`

    - `first_sentence_delay_ms: int`

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

    - `from_phone_number: str`

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

    - `is_cancelled: bool`

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

    - `is_completed: bool`

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

    - `last_call_attempt: Optional[CallLastCallAttempt]`

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

      - `id: str`

        The ID of the call attempt.

      - `answered_at: object`

        The time the call was answered.

      - `dial_error: Optional[Literal["number_non_attributed", "too_many_calls", "busy", 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: object`

        The time the call ended.

      - `phone_number: str`

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

      - `recording_url: Optional[str]`

        The URL of the audio recording of the call.

      - `result: Optional[Literal["IVR", "voicemail", "human", 2 more]]`

        - `"IVR"`

        - `"voicemail"`

        - `"human"`

        - `"unknown"`

        - `"ios-screening-filter"`

      - `started_at: object`

        The time the call started.

      - `status: Literal["queued", "ringing", "ongoing", 2 more]`

        The status of the call attempt.

        - `"queued"`

        - `"ringing"`

        - `"ongoing"`

        - `"completed"`

        - `"error"`

      - `end_reason: Optional[str]`

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

      - `ended_by: Optional[Literal["agent", "user", "system"]]`

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

        - `"agent"`

        - `"user"`

        - `"system"`

      - `structured_output: Optional[Dict[str, object]]`

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

      - `transcript: Optional[List[CallLastCallAttemptTranscript]]`

        The transcript of the call.

        - `content: str`

        - `role: Literal["user", "assistant", "tool"]`

          - `"user"`

          - `"assistant"`

          - `"tool"`

        - `tool_arguments: Optional[Union[Dict[str, object], str, null]]`

          - `Dict[str, object]`

          - `str`

        - `tool_is_error: Optional[bool]`

        - `tool_name: Optional[str]`

    - `llm_model: CallLlmModel`

      - `class CallLlmModelUnionMember0: …`

        - `name: Literal["gpt-4.1", "ministral-3-8b-instruct"]`

          - `"gpt-4.1"`

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

        - `type: Literal["dedicated-instance"]`

          - `"dedicated-instance"`

      - `class CallLlmModelUnionMember1: …`

        - `openrouter_model_id: str`

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

        - `openrouter_provider: str`

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

        - `type: Literal["openrouter"]`

          Use a model from OpenRouter.

          - `"openrouter"`

    - `metadata: Optional[Dict[str, str]]`

      Metadata stored with the call.

    - `organization_id: str`

      The ID of the organization that owns the call.

    - `scheduled_at: object`

      The time the call order is scheduled to start.

    - `status: Literal["initializing", "queued_for_calling", "calling", 4 more]`

      The status of the call.

      - `"initializing"`

      - `"queued_for_calling"`

      - `"calling"`

      - `"scheduled"`

      - `"completed"`

      - `"cancelled"`

      - `"errored"`

    - `to_phone_number: str`

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

### Example

```python
import os
from revox import Revox

client = Revox(
    api_key=os.environ.get("REVOX_API_KEY"),  # This is the default and can be omitted
)
call = client.call.create(
    phone_number="phone_number",
)
print(call.call)
```

## List

`call.list(CallListParams**kwargs)  -> CallListResponse`

**get** `/call`

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.

### Parameters

- `page: int`

  The page number you want to get. Starting at 0.

- `page_size: int`

  The number of calls to return per page.

- `statuses: Optional[List[Literal["initializing", "queued_for_calling", "calling", 4 more]]]`

  - `"initializing"`

  - `"queued_for_calling"`

  - `"calling"`

  - `"scheduled"`

  - `"completed"`

  - `"cancelled"`

  - `"errored"`

### Returns

- `class CallListResponse: …`

  - `calls: List[Call]`

    - `id: str`

      The ID of the call attempt.

    - `answered_at: object`

      The time the call was answered.

    - `dial_error: Optional[Literal["number_non_attributed", "too_many_calls", "busy", 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: object`

      The time the call ended.

    - `phone_number: str`

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

    - `recording_url: Optional[str]`

      The URL of the audio recording of the call.

    - `result: Optional[Literal["IVR", "voicemail", "human", 2 more]]`

      - `"IVR"`

      - `"voicemail"`

      - `"human"`

      - `"unknown"`

      - `"ios-screening-filter"`

    - `started_at: object`

      The time the call started.

    - `status: Literal["queued", "ringing", "ongoing", 2 more]`

      The status of the call attempt.

      - `"queued"`

      - `"ringing"`

      - `"ongoing"`

      - `"completed"`

      - `"error"`

    - `end_reason: Optional[str]`

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

    - `ended_by: Optional[Literal["agent", "user", "system"]]`

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

      - `"agent"`

      - `"user"`

      - `"system"`

    - `structured_output: Optional[Dict[str, object]]`

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

    - `transcript: Optional[List[CallTranscript]]`

      The transcript of the call.

      - `content: str`

      - `role: Literal["user", "assistant", "tool"]`

        - `"user"`

        - `"assistant"`

        - `"tool"`

      - `tool_arguments: Optional[Union[Dict[str, object], str, null]]`

        - `Dict[str, object]`

        - `str`

      - `tool_is_error: Optional[bool]`

      - `tool_name: Optional[str]`

### Example

```python
import os
from revox import Revox

client = Revox(
    api_key=os.environ.get("REVOX_API_KEY"),  # This is the default and can be omitted
)
calls = client.call.list(
    page=1,
    page_size=1,
)
print(calls.calls)
```