---
title: "List All Conversations"
method: GET
path: "/v1/conversations"
tags: ["Conversations"]
---

# List All Conversations

`GET /v1/conversations`

List All Conversations

## Query parameters

- `search_by` string, nullable — Field name to search by
- `search_value` string, nullable — Value to search for in the specified field
- `status` string, nullable — Filter by status
- `sort_by` string, nullable — Field to sort by
- `sort_order` 'asc' | 'desc'
- `skip` integer — Number of records to skip
- `limit` integer — Maximum number of records to return

## Response `200`

List of conversations retrieved successfully

- 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/versions/8f7b69ee5a90/schema)