Skip to main content
GET
/
v2
/
conversations
List Conversations
curl --request GET \
  --url https://tavusapi.com/v2/conversations \
  --header 'x-api-key: <api-key>'
{
  "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",
      "replica_id": "r90bbd427f71",
      "persona_id": "pcb7a34da5fe",
      "created_at": "",
      "updated_at": "<string>"
    }
  ],
  "total_count": 123
}
For AI agents, use https://docs.tavus.io/openapi.yaml for the full HTTP API contract.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
limit
integer

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

​
page
integer

The page number to return. Default is 1.

​
status
string

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

Response

​
data
object[]

Conversations for the current page; use total_count for the full count under the applied filters.

​
total_count
integer

The total number of conversations given the filters provided.