Skip to main content
GET
/
v2
/
conversations
/
{conversation_id}
Get Conversation
curl --request GET \
  --url https://tavusapi.com/v2/conversations/{conversation_id} \
  --header 'x-api-key: <api-key>'
{
  "conversation_id": "c123456",
  "conversation_name": "A Meeting with Hassaan",
  "conversation_url": "https://tavus.daily.co/c123456",
  "callback_url": "https://yourwebsite.com/webhook",
  "status": "active",
  "replica_id": "r90bbd427f71",
  "persona_id": "pcb7a34da5fe",
  "created_at": "2026-04-29T12:00:00Z",
  "updated_at": "2026-04-29T12:05:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tavus.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
conversation_id
string
required

The unique identifier of the conversation.

Example:

"c123456"

Query Parameters

​
verbose
boolean
default:false

Append verbose=true to the URL to receive additional event data in the response, including:

  • shutdown_reason: The reason why the conversation ended (e.g., "participant_left_timeout")
  • system.replica_joined: When the replica joined the conversation
  • system.shutdown: When and why the conversation ended
  • application.transcription_ready: The end-of-call transcript. Each entry in properties.transcript has role (user / assistant / system / tool), content, timestamp (Unix epoch float, seconds), seconds_from_start, duration (seconds, float) and inference_id where available.
  • application.perception_analysis: The final visual analysis of the user that includes their appearance, behavior, emotional states, and screen activities

This is particularly useful as an alternative to using the callback_url parameter on the create conversation endpoint for retrieving detailed conversation data.

Response

​
conversation_id
string

A unique identifier for the conversation.

Example:

"c123456"

​
conversation_name
string

The name of the conversation.

Example:

"A Meeting with Hassaan"

​
conversation_url
string

A direct link to join the conversation.

Example:

"https://tavus.daily.co/c123456"

​
callback_url
string

The url that will receive webhooks with updates of the conversation state.

Example:

"https://yourwebsite.com/webhook"

​
status
string

The status of the conversation.

Example:

"active"

​
replica_id
string

A unique identifier for the replica used to create this conversation

Example:

"r90bbd427f71"

​
persona_id
string

A unique identifier for the persona used to create this conversation

Example:

"pcb7a34da5fe"

​
created_at
string

The date and time the conversation was created.

Example:

""

​
updated_at
string

The date and time of when the conversation was last updated.

Example:

""

​
events
object[] | null

When verbose=true, additional conversation events (e.g. shutdown, perception analysis payloads, end-of-call transcript).