GET
/
v1
/
convai
/
conversations
Python
from elevenlabs import ElevenLabs

client = ElevenLabs(
    api_key="YOUR_API_KEY",
)
client.conversational_ai.get_conversations(
    agent_id="21m00Tcm4TlvDq8ikWAM",
)
{
  "conversations": [
    {
      "agent_id": "<string>",
      "agent_name": "<string>",
      "conversation_id": "<string>",
      "start_time_unix_secs": 123,
      "call_duration_secs": 123,
      "message_count": 123,
      "status": "processing",
      "call_successful": "success"
    }
  ],
  "next_cursor": "<string>",
  "has_more": true
}

Headers

​
xi-api-key
string

Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.

Query Parameters

​
cursor
string

Used for fetching next page. Cursor is returned in the response.

​
agent_id
string

The id of the agent you're taking the action on.

​
call_successful
enum<string>

The result of the success evaluation An enumeration.

Available options:
success,
failure,
unknown
​
page_size
integer
default:30

How many conversations to return at maximum. Can not exceed 100, defaults to 30.

Required range: 1 <= x <= 100

Response

200
application/json

Successful Response

The response is of type object.