---
title: "Get conversation by ID"
method: GET
path: "/conversation/{id}"
tags: ["Conversations"]
---

# Get conversation by ID

`GET /conversation/{id}`

## Request

- Base URL: `https://api.telvana.com`
- URL: `https://api.telvana.com/conversation/{id}`
- Auth: API key in header `x-api-key`

Retrieve details of a specific conversation including transcript and analytics

## Path parameters

- `id` string, required

## Response `200`

Conversation retrieved successfully

- object
  - `data` object
    - `id` string, required: ID of conversation
    - `dateInitiated` string, date-time, required: Date initialized of conversation (ISO timestamp)
    - `agentId` string, required: ID of Agent used in the conversation
    - `direction` 'INBOUND' | 'OUTBOUND', required: Direction of call: OUTBOUND (Calling a Human) or INBOUND (Incoming Call from Human)
    - `tags` string[], required: Zero or more tags for the conversation (built-in and custom)
    - `summary` string, nullable, required: AI-generated summary of the conversation
    - `durationSeconds` number, required: Precise call duration in seconds
    - `cost` number, required: Cost of the call in cents
    - `humanPhoneNumber` string, required: The customer/human's phone number
    - `agentPhoneNumber` string, required: The phone number used by the AI agent
    - `sentimentClassification` 'POSITIVE' | 'NEUTRAL' | 'NEGATIVE' | 'N_A', nullable, required: Sentiment classification of the conversation. N_A indicates no sentiment is available (e.g., the call failed to connect).
    - `transcript` string: Full text transcript of the conversation
    - `recordingUrl` string: Pre-signed S3 URL for downloading the audio recording (expires in 1 hour)

## Other responses

- `401`: Unauthorized - Invalid API key
- `404`: Conversation not found

---

[API](https://skmtc.dev/telvana/apis/telvana-api.md) · [All operations](https://skmtc.dev/telvana/apis/telvana-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telvana/apis/telvana-api/revisions/a70ff9063cdf?raw)