---
title: "List All Interactions"
method: GET
path: "/interactions/"
tags: ["Interactions"]
---

# List All Interactions

`GET /interactions/`

Lists all existing interactions. Results can be filtered by encounter status and patient identifier.

## Query parameters

- `sort` 'id' | 'assignedUserId' | 'patient' | 'createdAt' | 'endedAt' | 'updatedAt' — Field used to sort interactions. Default is createdAt.
- `direction` 'asc' | 'desc'
- `pageSize` integer — Number of interactions to return per page. Must be greater than 0. Default is 10.
- `index` integer — Page number to retrieve. Starts at 1. For example, index=2 with pageSize=10 will return interactions 11–20. Must be greater than 0. Default is 1.
- `encounterStatus` InteractionsEncounterStatusEnum[] — The status of the encounter. To filter on multiple statuses, pass the same parameter again.
- `patient` string — A unique identifier for the patient.

## Headers

- `Tenant-Name` string, required — Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

## Response `200`

- InteractionsListResponse
  - `interactions` InteractionsGetResponse[], required
    - `id` string, uuid, required
    - `assignedUserId` string, uuid, required
    - `encounter` InteractionsEncounterResponse, required
      - `identifier` string, required — A unique identifier for the encounter, essential for tracking and referencing specific patient interactions.
      - `status` 'planned' | 'in-progress' | 'on-hold' | 'completed' | 'cancelled' | 'deleted', required
      - `type` 'first_consultation' | 'consultation' | 'emergency' | 'inpatient' | 'outpatient', required
      - `period` InteractionsEncounterPeriod, required
        - `startedAt` string, date-time, required — The start date/time of the encounter. (UTC)
        - `endedAt` string, date-time, nullable — The end date/time of the encounter. (UTC)
      - `title` string, nullable — A readable name for the interaction
    - `patient` InteractionsPatient, required
      - `identifier` string, required — FHIR reference to patient identifier.
      - `name` string, nullable — FHIR reference to Text representation of the full name.
      - `gender` 'male' | 'female' | 'unknown' | 'other'
      - `birthDate` string, date-time, nullable — FHIR reference to patient birth date.
      - `pronouns` string, nullable — FHIR reference to patient extension Individual Pronouns.
    - `endedAt` string, date-time, nullable — The timestamp when the interaction concluded (UTC).
    - `createdAt` string, date-time, required — The timestamp when the interaction was started (UTC).
    - `updatedAt` string, date-time, required — The timestamp when the interaction was last modified (UTC).
    - `websocketUrl` string, required — WebSocket URL for streaming real-time interactions. Append a token in the format: /interactions/{interactionID}/streams?token=Bearer token-value-here
    - `lastUpdated` string, date-time, required — The timestamp indicating the last recorded update for this interaction.

## Other responses

- `403` — RFC9457
- `504` — RFC9457

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/revisions/5d1895a1b3fc/schema)