Get conversation details

Get the details of a particular conversation

Path parameters

conversation_idstringRequired

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

Query parameters

formatenumOptionalDefaults to json

Response format. Defaults to ‘json’. Set to ‘opentelemetry’ for an OTLP-compatible trace payload using the same structure as the post-call webhook.

Allowed values:

Response

Successful Response

agent_idstring

statusenum

Allowed values:

metadataobject

conversation_idstring

has_audioboolean

has_user_audioboolean

has_response_audioboolean

transcriptlist of objects

agent_namestring or null

user_idstring or null

branch_idstring or null

version_idstring or null

The ID of the agent version used for this conversation

analysisobject or null

visited_agentslist of objects

conversation_initiation_client_dataobject

environmentstringDefaults to production

tag_idslist of strings

Conversation tag ids assigned to this conversation.

otlp_tracesmap from strings to any or null

OpenTelemetry trace payload when the request uses format=opentelemetry; otherwise omitted.

Errors

422

Unprocessable Entity Error

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

Response format. Defaults to ‘json’. Set to ‘opentelemetry’ for an OTLP-compatible trace payload using the same structure as the post-call webhook.

The ID of the agent version used for this conversation

Conversation tag ids assigned to this conversation.

OpenTelemetry trace payload when the request uses format=opentelemetry; otherwise omitted.

1	{
2	"agent_id": "123",
3	"status": "processing",
4	"metadata": {
5	"start_time_unix_secs": 1714423232,
6	"call_duration_secs": 10
7	},
8	"conversation_id": "123",
9	"has_audio": true,
10	"has_user_audio": true,
11	"has_response_audio": true,
12	"transcript": [
13	{
14	"role": "user",
15	"time_in_call_secs": 10,
16	"message": "Hello, how are you?"
17	}
18	]
19	}

1	{
2	"agent_id": "123",
3	"status": "processing",
4	"metadata": {
5	"start_time_unix_secs": 1714423232,
6	"call_duration_secs": 10
7	},
8	"conversation_id": "123",
9	"has_audio": true,
10	"has_user_audio": true,
11	"has_response_audio": true,
12	"transcript": [
13	{
14	"role": "user",
15	"time_in_call_secs": 10,
16	"message": "Hello, how are you?"
17	}
18	]
19	}

Get conversation details

Path parameters

Headers

Query parameters

Response

Errors

Path parameters

Headers

Query parameters

Response

Errors

$	curl https://api.elevenlabs.io/v1/convai/conversations/123 \
>	-H "xi-api-key: xi-api-key"