---
title: "Get a Specific Conversation by ID"
method: GET
path: "/v1/conversations/{conversation_id}"
tags: ["Conversations"]
---

# Get a Specific Conversation by ID

`GET /v1/conversations/{conversation_id}`

Get a Specific Conversation by ID

## Path parameters

- `conversation_id` string, required — ID of the conversation

## Response `200`

Conversation retrieved successfully

- ConversationOutput — Any conversation happening between the end user and assistant is stored in this table
  - `id` string
  - `orgId` string
  - `prospectId` string, nullable
  - `source` string
  - `sourceType` string
  - `aiAgentId` string
  - `transcriptText` DialogLine[], nullable
    - `speaker` string, required
    - `message` string, required
    - `timestamp` string, date-time, required
    - `message_id` string, required
  - `transcriptSummary` string, nullable
  - `transcriptRecordingUrl` string, nullable
  - `timestampStart` string, date-time
  - `timestampEnd` string, date-time, nullable
  - `conversationAnalytics` ConversationAnalyticsModel — Expected output of the post conversation task
    - `summary` string, required — Summary of the conversation happened with important details on the conversation. The summary should be concise and to the point. It should contain the important details of the conversation like name, phone number, email, address and any other details shared by the user.
    - `action_items` string[], nullable, required — List of action items and the next steps to be performed from the conversation details.
    - `is_audio_consent_given` boolean, required — If the user has given consent to store the audio of the conversation. Unless the user explicitly says yes, this should be false.
    - `email_address_of_caller` string, nullable, required — Extracted email address of the caller from the conversation details. Email should be a valid email address format
    - `name_of_caller` string, nullable, required — Extracted name of the caller from the conversation details.
    - `phone_number_of_caller` string, nullable, required — Extracted phone number of the caller from the conversation details.
    - `address_of_caller` string, nullable, required — Extracted address of the caller from the conversation details.
    - `sentiment_of_caller` 'positive' | 'negative' | 'neutral', required
    - `prospectStatus` 'NEW' | 'GENERAL_ENQUIRY' | 'SCHEDULED_CALLBACK_WITH_BOT' | 'SCHEDULED_APPOINTMENT_WITH_PERSON' | 'SCHEDULED_APPOINTMENT_FOR_SERVICE' | 'NOT_INTERESTED' | 'PRODUCT_ORDER_PLACED' | 'SERVICE_ORDER_PLACED', required
  - `status` string, required
  - `createdBy` string
  - `createdAt` string, date-time
  - `updatedBy` string
  - `updatedAt` string, date-time

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/tratahq/apis/trata-ai-api.md) · [All operations](https://skmtc.net/tratahq/apis/trata-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tratahq/trata-ai-api/versions/8f7b69ee5a90/schema)