---
title: "List conversations"
method: GET
path: "/v1/avatar_conversations"
tags: ["Avatars"]
---

# List conversations

`GET /v1/avatar_conversations`

List realtime avatar conversations for the authenticated user with cursor-based pagination. Each conversation corresponds to a realtime session, and the conversation ID matches the realtime session ID. Pass `avatar` to restrict results to a single avatar.

## Query parameters

- `cursor` string
- `limit` integer, required
- `avatar` string, uuid
- `startDate` string, date-time
- `endDate` string, date-time

## Headers

- `X-Runway-Version` '2024-11-06', required

## Response `200`

Success

- object
  - `data` object[], required — Array of conversation summaries.
    - `id` string, uuid, required — Unique conversation identifier. This is the same value as the realtime session ID for the call.
    - `name` string, required — Conversation name (auto-generated or user-provided).
    - `status` 'in_progress' | 'ended' | 'failed', required — The status of the conversation. `in_progress` means the session is active, `ended` means it completed successfully, `failed` means it ended due to an error.
    - `avatar` union, required — The avatar used in this conversation, or null if unavailable.
      - object — A preset avatar.
        - `type` 'runway-preset', required
        - `presetId` string, required — The preset avatar ID.
        - `name` string, required — The preset avatar's display name (e.g. "Mina").
      - object — A custom avatar created by the user.
        - `type` 'custom', required
        - `id` string, uuid, nullable, required — The custom avatar ID, or null if deleted.
        - `name` string, nullable, required — The avatar's configured name, or null if unavailable.
    - `createdAt` string, date-time, required — When the conversation was created.
    - `duration` integer, nullable, required — Duration of the conversation in seconds, or null if not started.
    - `hasTools` boolean, required — Whether tools were configured for this conversation session.
  - `hasMore` boolean, required — Whether there are more conversations to fetch.
  - `nextCursor` string, nullable, required — Cursor to use for fetching the next page, or null if no more pages.

---

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