---
title: "Get Conversation"
method: GET
path: "/v2/conversations/{conversation_id}"
tags: ["Conversations"]
---

# Get Conversation

`GET /v2/conversations/{conversation_id}`

This endpoint returns a single conversation by its unique identifier.

## Query parameters

- `verbose` boolean

## Response `200`

- object
  - `conversation_id` string — A unique identifier for the conversation.
  - `conversation_name` string — The name of the conversation.
  - `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.
  - `status` string — The status of the conversation.
  - `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.
  - `events` object[], nullable — When `verbose=true`, additional conversation events (e.g. shutdown, perception analysis payloads, end-of-call transcript).
    - `event_type` string — Event name (e.g. system.pal_joined, system.replica_joined, application.transcription_ready, application.perception_analysis, application.perception_unavailable, application.post_call_action_executed).
    - `timestamp` string — ISO 8601 time of the event.
    - `properties` object — Event-specific payload when present. For `application.transcription_ready`, includes a `transcript` array of per-turn entries.

## Other responses

- `400` — Bad Request
- `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)
