v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Get Conversation by ID.

Retrieves detailed information about a specific conversation including call logs, performance metrics, and associated voice agent configuration.

get/v1/voice-agents/conversation/{conversationId}

Path parameters

conversationIdstring uuid required

Example:849e77c6-5cb3-479a-a985-7fab630e2c78

UUID of the conversation to retrieve.

Response

Successful response

successboolean

messagestring

Example response

{
  "success": true,
  "message": "Success",
  "data": {
    "id": "849e77c6-5cb3-479a-a985-7fab630e2c78",
    "model": "gpt-4",
    "status": "COMPLETED",
    "type": "VOICE_AGENTS",
    "processingType": "real-time",
    "voiceAgentId": "d949f13f-40d2-4e48-ac86-b66633070603",
    "apiKeyId": "d949f13f-40d2-4e48-ac86-b66633070603",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:35:00Z",
    "title": "Customer Support Call",
    "mediaUrl": "https://storage.example.com/recordings/123.mp3",
    "callParams": {
      "userNumber": "+1234567890"
    },
    "callDuration": 125,
    "channelType": "TELEPHONE",
    "logs": [
      {
        "id": "log_123",
        "timestamp": "2024-01-15T10:30:15Z",
        "createdAt": "2024-01-15T10:30:15Z",
        "updatedAt": "2024-01-15T10:30:15Z"
      }
    ]
  }
}