---
title: "List calls"
method: GET
path: "/calls"
---

# List calls

`GET /calls`

## Request

- Base URL: `https://public-api.leexi.ai/v1`
- URL: `https://public-api.leexi.ai/v1/calls`
- Auth: API key in header `Authorization`

List all calls and meetings within the API key's access scope. Keys with whole-company access list every call; scoped keys list only the calls they can access.

## Query parameters

- `page` integer
- `items` integer
- `order` 'created_at desc' | 'created_at asc' | 'performed_at desc' | 'performed_at asc' | 'updated_at desc' | 'updated_at asc'
- `date_filter` 'created_at' | 'performed_at' | 'updated_at'
- `from` string
- `to` string
- `source` string
- `source_id` string[]
- `owner_uuid` string[]
- `participating_user_uuid` string[]
- `conversation_type_uuid` string
- `customer_phone_number` string[]
- `customer_email_address` string[]
- `with_simple_transcript` boolean

## Response `200`

200

- object
  - `data` object[]
    - `audio_archived_at` string
    - `chapters` object[]
      - `index` integer
      - `start_time` integer
      - `text` string
      - `title` string
      - `uuid` string
    - `completions_archived_at` unknown
    - `conversation_type` object
      - `active` boolean
      - `slug` string
      - `uuid` string
    - `created_at` string
    - `custom_fields` object: Free-form key/value pairs sent at creation for custom integrations agreed with Leexi. Empty for every other call.
    - `customer_email_addresses` string[]: ⚠️ DEPRECATED — kept for backward compatibility only. Use the `customers` array instead (read its `email` attribute).
    - `customer_phone_numbers` string[]: ⚠️ DEPRECATED — kept for backward compatibility only. Use the `customers` array instead (read its `phone_number` attribute).
    - `customers` object[]: The external participants (customers) of the call. Replaces the deprecated `customer_email_addresses` and `customer_phone_numbers`.
      - `email` string
      - `name` string
      - `phone_number` string
      - `uuid` string
    - `deal` unknown
    - `description` string
    - `direction` string
    - `duration` number
    - `feedbacks` object[]
    - `is_video` boolean
    - `leexi_url` string
    - `locale` string
    - `meeting_event` unknown
    - `owner` object
      - `email` string
      - `name` string
      - `uuid` string
    - `participating_users` object[]
      - `email` string
      - `name` string
      - `uuid` string
    - `performed_at` string
    - `prompts` object[]
      - `category` string
      - `completions` string[]
      - `title` string
      - `uuid` string
    - `recording_url` string, nullable: Signed URL of the call recording. `null` when the recording has been archived or when the company has disabled audio/video retention.
    - `scorecards` object[]
    - `simple_transcript` string
    - `source` string
    - `source_id` string
    - `speakers` object[]
      - `duration` number
      - `email_address` string
      - `index` integer
      - `is_user` boolean
      - `longest_monologue` number
      - `name` string
      - `phone_number` unknown
      - `uuid` string
    - `summary` string
    - `tags` object[]
      - `color` string
      - `name` string
      - `uuid` string
    - `tasks` object[]
      - `active` boolean
      - `created_at` string
      - `description` string
      - `done` boolean
      - `last_editor` object
        - `active` boolean
        - `email` string
        - `name` string
        - `uuid` string
      - `speaker` object
        - `duration` integer
        - `email_address` string
        - `index` integer
        - `is_user` boolean
        - `longest_monologue` integer
        - `name` string
        - `phone_number` string
        - `uuid` string
      - `subject` string
      - `updated_at` string
      - `uuid` string
    - `title` string
    - `transcript_archived_at` unknown
    - `transcript_url` string
    - `updated_at` string
    - `uuid` string
    - `video_archived_at` string
    - `visible` boolean
  - `pagination` object
    - `count` integer
    - `items` integer
    - `page` integer
    - `pages` integer

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/leexi/apis/leexi-public-api.md) · [All operations](https://skmtc.dev/leexi/apis/leexi-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leexi/apis/leexi-public-api/revisions/3d10e45c30f5?raw)