v1

latestOpenAPI 3.0.32026-07-267015229.9 KB
Conversations

List Conversations

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

get/v2/conversations

Query parameters

limitinteger

The number of conversations to return per page. Default is 10.

pageinteger

The page number to return. Default is 1.

statusstring

Filter the conversations by status. Possible values: active, ended.

Response

total_countinteger

The total number of conversations given the filters provided.

Example response

{
  "data": [
    {
      "conversation_id": "c123456",
      "conversation_name": "A Meeting with Hassaan",
      "status": "active",
      "conversation_url": "https://tavus.daily.co/c123456",
      "callback_url": "https://yourwebsite.com/webhook",
      "face_id": "r90bbd427f71",
      "pal_id": "pcb7a34da5fe"
    }
  ]
}