---
title: "List call events"
method: GET
path: "/call_events"
tags: ["Debugging"]
---

# List call events

`GET /call_events`

Filters call events by given filter parameters. Events are ordered by `occurred_at`. If filter for `leg_id` or `application_session_id` is not present, it only filters events from the last 24 hours.

**Note**: Only one `filter[occurred_at]` can be passed.

## Query parameters

- `filter` object
  - `application_name` object — Application name filters
    - `contains` string — If present, applications with <code>application_name</code> containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.
  - `outbound.outbound_voice_profile_id` string — Identifies the associated outbound voice profile.
  - `leg_id` string, uuid — The unique identifier of an individual call leg.
  - `application_session_id` string, uuid — The unique identifier of the call session. A session may include multiple call leg events.
  - `connection_id` string — The unique identifier of the conection.
  - `product` 'call_control' | 'fax' | 'texml' — Filter by product.
  - `failed` boolean — Delivery failed or not.
  - `from` string — Filter by From number.
  - `to` string — Filter by To number.
  - `name` string — If present, conferences will be filtered to those with a matching `name` attribute. Matching is case-sensitive
  - `type` 'command' | 'webhook' — Event type
  - `occurred_at` object — Event occurred_at filters
    - `eq` string — Event occurred_at: equal
    - `gt` string — Event occurred_at: greater than
    - `gte` string — Event occurred_at: greater than or equal
    - `lt` string — Event occurred_at: lower than
    - `lte` string — Event occurred_at: lower than or equal
  - `status` 'init' | 'in_progress' | 'completed' — If present, conferences will be filtered by status.
- `page` object
  - `after` string — Opaque identifier of next page
  - `before` string — Opaque identifier of previous page
  - `limit` integer — Limit of records per single page
  - `size` integer — The size of the page
  - `number` integer — The page number to load

## Response `200`

Successful response with a list of call events.

- object
  - `data` CallEvent[]
    - `record_type` 'call_event', required
    - `call_leg_id` string, required — Uniquely identifies an individual call leg.
    - `call_session_id` string, required — Uniquely identifies the call control session. A session may include multiple call leg events.
    - `event_timestamp` string, required — Event timestamp
    - `name` string, required — Event name
    - `type` 'command' | 'webhook', required — Event type
    - `metadata` object, required — Event metadata, which includes raw event, and extra information based on event type
  - `meta` PaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `422` — Unprocessable entity. The request was well-formed but could not be processed due to semantic errors. This includes validation errors, invalid parameter values, call state errors, conference errors, queue errors, recording/transcription errors, and business logic violations.
- `default` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)