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": "r79e1c033f",
  "persona_id": "p5317866",
  "created_at": "",
  "updated_at": ""
}
You can 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”)
  • transcript: A complete transcript of the conversation with role-based messages (via application.transcription_ready)
  • system.replica_joined: When the replica joined the conversation
  • system.shutdown: When and why the conversation ended
  • 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.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
conversation_id
string
required

The unique identifier of the conversation.

Example:

"c123456"

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:

"r79e1c033f"

​
persona_id
string

A unique identifier for the persona used to create this conversation

Example:

"p5317866"

​
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:

""