---
title: "Get Conversation"
method: GET
path: "/v1/conversations/{conversationId}"
---

# Get Conversation

`GET /v1/conversations/{conversationId}`

Return the available details for one organization-visible conversation.

Includes the transcript, recordings, and AI-generated summary when present.
Requires the **Export** permission (`read` scope). Private conversations owned
by individual users are excluded.

## Path parameters

- `conversationId` string, uuid, required

## Response `200`

Successful Response

- ConversationDetail
  - `conversationId` string, uuid, required
  - `sourceId` string, nullable
  - `title` string, nullable
  - `startTime` string, date-time, required
  - `endTime` string, date-time, required
  - `type` 'INTERNAL' | 'EXTERNAL', required
  - `category` union
    - 'prospect_discovery' | 'prospect_demo' | 'prospect_trial' | 'prospect_negotiation' | 'closed_lost' | 'closed_won' | 'customer_onboarding' | 'customer_support' | 'customer_checkin' | 'customer_commercials' | 'interview' | 'user_research' | 'partner_call' | 'consulting_call' | 'advisor_call' | 'investor_call' | 'vendor_call' | 'other'
    - 'one_on_one' | 'sales_team' | 'customer_team' | 'customer_service_team' | 'marketing_team' | 'product_team' | 'engineering_team' | 'it_team' | 'hr_team' | 'operations_team' | 'finance_team' | 'legal_team' | 'investment_team' | 'consulting_team' | 'company_wide' | 'other'
  - `participants` Participant[], required
    - `name` string, nullable
    - `email` string, nullable
    - `attended` boolean
  - `crm` CRMInfo
    - `id` string, nullable
    - `name` string, nullable
    - `type` 'contact' | 'account' | 'opportunity' | 'lead' | 'owner' | 'activity' | 'task'
  - `summary` object, nullable
  - `transcript` TranscriptEntry[], nullable
    - `speaker` string, required
    - `text` string, required
    - `startTime` number, required
    - `endTime` number, required
  - `recordings` Recordings
    - `videoUrl` string, nullable
    - `videoStreamUrl` string, nullable
    - `audioUrl` string, nullable
    - `audioStreamUrl` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-13** `f499ec011b17` — 3 warning
  - added the new `consulting_call` enum value to the `category/anyOf[subschema #1: ExternalCategory]/` response property for the response status `200`
  - added the new `consulting_team` enum value to the `category/anyOf[subschema #2: InternalCategory]/` response property for the response status `200`
  - added the new `customer_service_team` enum value to the `category/anyOf[subschema #2: InternalCategory]/` response property for the response status `200`
- **2026-08-11** `f133fe4cb7f2` — 1 warning
  - added the new `partner_call` enum value to the `category/anyOf[subschema #1: ExternalCategory]/` response property for the response status `200`

[Change history](https://skmtc.dev/sybill/apis/sybill-api/changes/v1/conversations/:conversationId/get.md)

---

[API](https://skmtc.dev/sybill/apis/sybill-api.md) · [All operations](https://skmtc.dev/sybill/apis/sybill-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sybill/sybill-api/revisions/f499ec011b17/schema)