Skip to main content

Get Conversation

Retrieve a specific conversation by ID. Users can only access conversations for their own agents.
path
string
required
Conversation ID
curl -X GET "https://api.example.com/api/v1/conversations/conv_abc123" \
  -H "X-API-Key: your-api-key-here"

Response

status
object
Response status information
code
integer
HTTP status code (200)
message
string
Status message
data
object
Conversation object
conversation_id
string
Unique conversation identifier
agent_id
string
Associated agent ID
agent_name
string
Name of the agent
status
string
Conversation status
transcript
array
Array of conversation transcript entries
metadata
object
Additional conversation metadata
created_at
string
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

401
object
Unauthorized - Invalid or missing authentication
404
object
Conversation not found
400
object
Bad request - Missing API key
502
object
Bad gateway - ElevenLabs API error