---
title: "Get Conversation by ID."
method: GET
path: "/v1/voice-agents/conversation/{conversationId}"
---

# Get Conversation by ID.

`GET /v1/voice-agents/conversation/{conversationId}`

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

## Path parameters

- `conversationId` string, uuid, required

## Response `200`

Successful response

- GetConversationResponse
  - `success` boolean
  - `message` string
  - `data` ConversationDetail
    - `id` string, uuid — UUID of the conversation.
    - `model` string, nullable — AI model used for the conversation.
    - `agentDetails` object, nullable — Detailed configuration of the voice agent used in this conversation.
    - `jobResponse` object, nullable — Response data from the job execution.
    - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'NO_ANSWER' | 'FAILED' — Current status of the conversation.
    - `type` string — Type of job (should be VOICE_AGENTS).
    - `processingType` string, nullable — Type of processing used for the conversation.
    - `voiceAgentId` string, uuid, nullable — UUID of the voice agent.
    - `apiKeyId` string, uuid, nullable — UUID of the API key used.
    - `createdAt` string, date-time — Timestamp when the conversation was created.
    - `updatedAt` string, date-time — Timestamp when the conversation was last updated.
    - `title` string, nullable — Title or name of the conversation.
    - `mediaUrl` string, uri, nullable — Signed URL for accessing the call recording (if available).
    - `callParams` object, nullable — Parameters related to the call (e.g., phone numbers, settings).
      - `userNumber` string — Phone number of the user.
    - `callDuration` number, nullable — Duration of the call in seconds.
    - `channelType` string, nullable — Channel through which the conversation took place.
    - `callAnalysis` object, nullable — Analysis data for the call (may include error messages if call failed).
    - `voiceAgent` object, nullable — Voice agent configuration and associated resources.
      - `voiceAgentWebTools` object[] — Web tools configured for the voice agent.
        - `webTool` object — Web tool details.
      - `webTools` object, nullable — Legacy web tools configuration.
      - `voiceAgentKnowledgeBases` object[] — Knowledge bases associated with the voice agent.
        - `knowledgeBaseItem` object — Knowledge base item details.
    - `logs` ConversationLog[] — Detailed conversation logs retrieved from Agent Analytics service.
      - `id` string — Log entry ID.
      - `timestamp` string, date-time — Timestamp of the log entry.
      - `payload` object — Log payload data (parsed from JSON).
      - `createdAt` string, date-time — When the log was created.
      - `updatedAt` string, date-time — When the log was last updated.
    - `performanceMetrics` object — Performance metrics for the conversation retrieved from Agent Analytics service.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden - Not authorized to access this conversation
- `404` — Conversation not found
- `500` — Server Side Error

---

[API](https://skmtc.net/tryhamsa/apis/hamsa-api.md) · [All operations](https://skmtc.net/tryhamsa/apis/hamsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryhamsa/hamsa-api/versions/ecbeb5d8dc13/schema)