---
title: "List all conversations linked to a specific prospect"
method: GET
path: "/v1/prospects/{prospect_id}/conversations"
tags: ["ConversationProspectLink"]
---

# List all conversations linked to a specific prospect

`GET /v1/prospects/{prospect_id}/conversations`

List all conversations linked to a specific prospect

## Path parameters

- `prospect_id` string, required — ID of the prospect

## Response `200`

Successful Response

- ConversationOutput[]
  - `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/revisions/8f7b69ee5a90/schema)