---
title: "List scheduled events"
method: GET
path: "/ai/assistants/{assistant_id}/scheduled_events"
tags: ["Assistants"]
---

# List scheduled events

`GET /ai/assistants/{assistant_id}/scheduled_events`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/assistants/{assistant_id}/scheduled_events`
- Auth: HTTP bearer

Get scheduled events for an assistant with pagination and filtering

## Path parameters

- `assistant_id` string, required

## Query parameters

- `from_date` string, date-time
- `to_date` string, date-time
- `conversation_channel` 'phone_call' | 'sms_chat'
- `page` object
  - `size` integer
  - `number` integer

## Response `200`

Successful Response

- PaginatedScheduledEventList
  - `meta` Meta, required
    - `total_pages` integer, required
    - `total_results` integer, required
    - `page_number` integer, required
    - `page_size` integer, required
  - `data` union[], required
    - union
      - ScheduledPhoneCallEventResponse
        - `telnyx_conversation_channel` 'phone_call' | 'sms_chat', required
        - `telnyx_end_user_target` string, required
        - `telnyx_agent_target` string, required
        - `scheduled_at_fixed_datetime` string, date-time, required
        - `assistant_id` string, required
        - `retry_count` integer
        - `retry_attempts` integer
        - `scheduled_event_id` string
        - `conversation_id` string
        - `created_at` string, date-time
        - `status` 'pending' | 'in_progress' | 'completed' | 'failed'
        - `conversation_metadata` object
        - `dynamic_variables` object: A map of dynamic variable names to values. These variables can be referenced in the assistant's instructions and messages using {{variable_name}} syntax.
        - `errors` string[]
        - `call_status` string: Values: busy, canceled, no-answer, ringing, completed, failed, in-progress
        - `call_duration` integer: Duration of the call in seconds
        - `max_retries_client_errors` integer: Configure number of retries on client errors: busy, no-answer, failed, canceled (caller hung up before the callee answered)
        - `retry_interval_secs` integer
        - `call_attempts` AssistantScheduledCallAttempt[]
          - `attempt_number` integer, required
          - `attempted_at` string, date-time, required
          - `call_status` string, required: Values: busy, canceled, no-answer, ringing, completed, failed, in-progress
          - `call_duration` integer: Duration of the call in seconds
          - `telnyx_call_control_id` string
        - `dispatched_at` string, date-time: Date time at which call was sent
        - `call_settings` ScheduledCallSettings: Per-call telephony overrides applied when a scheduled phone-call event dispatches. Phone-call events only. New per-call dispatch options should be added here rather than as top-level event fields.
          - `sip_region` 'US' | 'Europe' | 'Canada' | 'Australia' | 'Middle East': SIP region passed to Telnyx when initiating an outbound call. Values match the Telnyx TeXML `SipRegion` parameter exactly. Telnyx defaults to `US` when omitted.
      - ScheduledSmsEventResponse
        - `telnyx_conversation_channel` 'phone_call' | 'sms_chat', required
        - `telnyx_end_user_target` string, required
        - `telnyx_agent_target` string, required
        - `scheduled_at_fixed_datetime` string, date-time, required
        - `assistant_id` string, required
        - `retry_count` integer
        - `text` string, required
        - `scheduled_event_id` string
        - `conversation_id` string
        - `created_at` string, date-time
        - `status` 'pending' | 'in_progress' | 'completed' | 'failed'
        - `conversation_metadata` object
        - `dynamic_variables` object: A map of dynamic variable names to values. These variables can be referenced in the assistant's instructions and messages using {{variable_name}} syntax.
        - `errors` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `a72569d69430`: 2 warning, 2 info
  - deleted the `query` request parameter `page[number]`
  - deleted the `query` request parameter `page[size]`
  - added the new optional `query` request parameter `page`
  - removed discriminator from `data/items/` response property for the response status `200`
- **2026-06-11** `81ee1b2477a2`: 1 info
  - added the optional property `data/items/anyOf[subschema #1: ScheduledPhoneCallEventResponse]/call_settings` to the response with the `200` status
- **2026-05-08** `30cb1ddce91b`: 6 info
  - added the optional property `data/items/anyOf[subschema #1: ScheduledPhoneCallEventResponse]/call_attempts` to the response with the `200` status
  - added the optional property `data/items/anyOf[subschema #1: ScheduledPhoneCallEventResponse]/call_duration` to the response with the `200` status
  - added the optional property `data/items/anyOf[subschema #1: ScheduledPhoneCallEventResponse]/call_status` to the response with the `200` status
  - added the optional property `data/items/anyOf[subschema #1: ScheduledPhoneCallEventResponse]/dispatched_at` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/ai/assistants/:assistant_id/scheduled_events/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)