Get Conversation
Retrieve a specific conversation by ID. Users can only access conversations for their own agents.
curl -X GET "https://api.example.com/api/v1/conversations/conv_abc123" \
-H "X-API-Key: your-api-key-here"
Response
Response status information
Conversation objectUnique conversation identifier
Array of conversation transcript entries
Additional conversation metadata
ISO 8601 timestamp when conversation started
{
"status": {
"code": 200,
"message": "Success"
},
"data": {
"conversation_id": "conv_abc123",
"agent_id": "123",
"agent_name": "Customer Support Agent",
"status": "completed",
"transcript": [
{
"role": "user",
"content": "Hello, I need help with my order",
"timestamp": "2024-01-15T10:30:00Z"
},
{
"role": "assistant",
"content": "I'd be happy to help you with your order. Can you provide your order number?",
"timestamp": "2024-01-15T10:30:05Z"
},
{
"role": "user",
"content": "My order number is 12345",
"timestamp": "2024-01-15T10:30:15Z"
},
{
"role": "assistant",
"content": "Thank you. I can see your order is currently being processed...",
"timestamp": "2024-01-15T10:30:20Z"
}
],
"metadata": {
"duration": 120,
"call_quality": "good",
"summary": "Customer inquired about order status for order #12345"
},
"created_at": "2024-01-15T10:30:00Z"
}
}
Error Responses
Unauthorized - Invalid or missing authentication
Bad request - Missing API key
Bad gateway - ElevenLabs API error