Conversational Video Interface
Get Conversation
This endpoint returns a single conversation by its unique identifier.
GET
/
v2
/
conversations
/
{conversation_id}
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 (viaapplication.transcription_ready
)perception_analysis
: A detailed analysis of the user’s appearance, behavior, emotional states, and screen activitiessystem.replica_joined
: When the replica joined the conversationsystem.shutdown
: When and why the conversation endedapplication.perception_analysis
: The final visual analysis of the user
This is particularly useful as an alternative to using the callback_url
parameter on the create conversation endpoint for retrieving detailed conversation data.
Authorizations
Path Parameters
Response
200 - application/json
The response is of type object
.
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": ""
}
Assistant
Responses are generated using AI and may contain mistakes.