---
title: "List Conversations"
method: GET
path: "/v2/conversations"
tags: ["Conversations"]
---

# List Conversations

`GET /v2/conversations`

This endpoint returns a list of all Conversations created by the account associated with the API Key in use.

## Query parameters

- `limit` integer
- `page` integer
- `status` string

## Response `200`

- object
  - `data` object[] — Conversations for the current page; use `total_count` for the full count under the applied filters.
    - `conversation_id` string — A unique identifier for the conversation.
    - `conversation_name` string — A name for the conversation.
    - `status` string — The status of the video.
    - `conversation_url` string — A direct link to join the conversation.
    - `callback_url` string — The url that will receive webhooks with updates of the conversation state.
    - `face_id` string — A unique identifier for the face used to create this conversation
    - `pal_id` string — A unique identifier for the PAL used to create this conversation
    - `created_at` string — The date and time the conversation was created.
    - `updated_at` string — The date and time of when the conversation was last updated.
  - `total_count` integer — The total number of conversations given the filters provided.

## Other responses

- `401` — UNAUTHORIZED

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)