---
title: "List Calls"
method: GET
path: "/comms/call/list"
tags: ["provider", "comms"]
---

# List Calls

`GET /comms/call/list`

## Query parameters

- `page` integer, nullable
- `per_page` integer, nullable
- `sort_by` string, nullable
- `sort_direction` 'asc' | 'desc', nullable
- `location_id` string, nullable
- `id` string, nullable
- `patient_id` string, nullable
- `user_id` string, nullable
- `user_name` string, nullable
- `created_date` string[], nullable
- `duration` integer, nullable
- `direction` 'INBOUND' | 'OUTBOUND'
- `status` CallStatus[], nullable
- `transcript_contains` string, nullable
- `tags` string[], nullable
- `phone_number` string, nullable
- `tz` string, required

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Response `200`

Successful Response

- PageCallTable
  - `data` CallTable[], required
    - `id` string, required
    - `sender` UserTiny
      - `id` string, required — The unique identifier for the user.
      - `firstName` string, nullable — The user's first name.
      - `lastName` string, nullable — The user's last name.
      - `phoneNumber` string, nullable — The user's phone number.
      - `email` string, nullable — The user's email address.
      - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
      - `locationId` string, nullable — The location of the user.
    - `receiver` UserTiny, required
      - `id` string, required — The unique identifier for the user.
      - `firstName` string, nullable — The user's first name.
      - `lastName` string, nullable — The user's last name.
      - `phoneNumber` string, nullable — The user's phone number.
      - `email` string, nullable — The user's email address.
      - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
      - `locationId` string, nullable — The location of the user.
    - `chatId` string, required
    - `direction` 'INBOUND' | 'OUTBOUND', required
    - `status` 'CREATED' | 'ONGOING' | 'TRANSFERRED' | 'DISCONNECTED' | 'FAILED' | 'FINISHED' | 'VOICEMAIL', required
    - `completedDate` string, date-time, nullable
    - `retellCallId` string, nullable
    - `disconnectionReason` string, nullable
    - `pathToAudio` string, nullable
    - `summary` string, nullable
    - `context` object, nullable
    - `createdDate` string, date-time, nullable
    - `toolCalls` ToolCallSummary[]
      - `id` string, required
      - `callId` string, nullable
      - `messageId` string, nullable
      - `alertId` string, nullable
      - `toolName` string, required
      - `toolArguments` object, required
      - `toolCallId` string, nullable
      - `result` object, nullable
      - `toolCallDescription` string, nullable
      - `hasBeenCalled` boolean
      - `createdDate` string, date-time, required
    - `tags` TagSummary[]
      - `name` string, required
      - `description` string, nullable
      - `useForAlerts` boolean, required
      - `useForCalls` boolean, required
      - `id` string, required
    - `invoiceId` string, nullable
    - `type` 'MANUAL' | 'AI'
    - `locationId` string, nullable
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)