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

# Get a Conversation

`GET /v1/conversations/{conversation_id}`

## Request

- Base URL: `https://api.monaco.com`
- URL: `https://api.monaco.com/v1/conversations/{conversation_id}`
- Auth: none declared

Gets the full ordered thread for a single email or LinkedIn conversation.

Message bodies are plain text (HTML emails are converted) and truncated past 20,000 characters.

## Path parameters

- `conversation_id` string, required: Conversation to fetch: the email `thread_id` or the LinkedIn `chat_id`

## Query parameters

- `channel` 'email' | 'linkedin', required
- `page` integer: Page number of messages within the thread
- `page_size` integer: Number of messages per page

## Response `200`

Successful Response

- PublicItemResponseConversationDetailResponse
  - `data` ConversationDetailResponse, required
    - `id` string, required: Unique identifier for the conversation
    - `channel` 'email' | 'linkedin', required
    - `subject` string, nullable: Subject line of the conversation
    - `participants` ConversationParticipantInfo[], required: All participants in the conversation
      - `name` string, required: Display name of the participant
      - `email` string, nullable: Email address of the participant
      - `linkedin_url` string, nullable: LinkedIn profile URL of the participant
      - `contact_id` string, nullable: ID of the associated contact
      - `company_name` string, nullable: Company name of the participant
      - `is_current_user` boolean: Whether this participant is the requesting user
    - `account_id` string, nullable: Deprecated: use `account_candidates`. ID of the associated account
    - `account_candidates` AccountCandidate[]: Accounts the conversation associates to
      - `account_id` string, required: ID of the account
      - `name` string, nullable: Display name of the account
    - `messages` ConversationMessageItem[], required: Messages in this page
      - `id` string, required: Unique identifier for the message
      - `channel` 'email' | 'linkedin', required
      - `sender` ConversationParticipantInfo, required
        - `name` string, required: Display name of the participant
        - `email` string, nullable: Email address of the participant
        - `linkedin_url` string, nullable: LinkedIn profile URL of the participant
        - `contact_id` string, nullable: ID of the associated contact
        - `company_name` string, nullable: Company name of the participant
        - `is_current_user` boolean: Whether this participant is the requesting user
      - `to` ConversationParticipantInfo[], nullable: TO recipients of the message
        - `name` string, required: Display name of the participant
        - `email` string, nullable: Email address of the participant
        - `linkedin_url` string, nullable: LinkedIn profile URL of the participant
        - `contact_id` string, nullable: ID of the associated contact
        - `company_name` string, nullable: Company name of the participant
        - `is_current_user` boolean: Whether this participant is the requesting user
      - `cc` ConversationParticipantInfo[], nullable: CC recipients of the message
        - `name` string, required: Display name of the participant
        - `email` string, nullable: Email address of the participant
        - `linkedin_url` string, nullable: LinkedIn profile URL of the participant
        - `contact_id` string, nullable: ID of the associated contact
        - `company_name` string, nullable: Company name of the participant
        - `is_current_user` boolean: Whether this participant is the requesting user
      - `bcc` ConversationParticipantInfo[], nullable: BCC recipients of the message
        - `name` string, required: Display name of the participant
        - `email` string, nullable: Email address of the participant
        - `linkedin_url` string, nullable: LinkedIn profile URL of the participant
        - `contact_id` string, nullable: ID of the associated contact
        - `company_name` string, nullable: Company name of the participant
        - `is_current_user` boolean: Whether this participant is the requesting user
      - `subject` string, nullable: Subject line of the message
      - `body` string, required: Plain-text body of the message
      - `body_truncated` boolean: Whether the body was truncated due to length
      - `timestamp` string, date-time, required: When the message was sent (ISO 8601)
    - `message_pagination` PaginationInfo, required
      - `page` integer, required: Current page number
      - `page_size` integer, required: Number of results per page
      - `total_count` integer, required: Total number of matching records
      - `total_pages` integer, required: Total number of pages
  - `meta` ResponseMeta
    - `timestamp` string, date-time: Server timestamp of the response

## Other responses

- `4XX`: Client error

## Changes

- **2026-11-03** `fc720ada2a81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monaco/apis/monaco-public-api/changes/v1/conversations/:conversation_id/get.md)

---

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