MOmonaco
Conversations

Get a Conversation

Changed on

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.

get/v1/conversations/{conversation_id}

Request

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

Path parameters

conversation_idstring required

Conversation to fetch: the email thread_id or the LinkedIn chat_id

Query parameters

channel'email' | 'linkedin' required

Channel of the conversation; must match conversation_id

pageinteger

Page number of messages within the thread

page_sizeinteger

Number of messages per page

Response

Successful Response

Example response

{
  "data": {
    "id": "thread_abc123",
    "subject": "Demo follow-up",
    "participants": [
      {
        "name": "Jane Smith",
        "email": "jane@acme.com",
        "linkedin_url": "https://linkedin.com/in/janesmith",
        "contact_id": "con_abc123",
        "company_name": "Acme Inc"
      }
    ],
    "account_id": "acc_abc123",
    "account_candidates": [
      {
        "account_id": "acc_abc123",
        "name": "Acme"
      }
    ],
    "messages": [
      {
        "id": "msg_abc123",
        "sender": {
          "name": "Jane Smith",
          "email": "jane@acme.com",
          "linkedin_url": "https://linkedin.com/in/janesmith",
          "contact_id": "con_abc123",
          "company_name": "Acme Inc"
        },
        "to": [
          {
            "name": "Jane Smith",
            "email": "jane@acme.com",
            "linkedin_url": "https://linkedin.com/in/janesmith",
            "contact_id": "con_abc123",
            "company_name": "Acme Inc"
          }
        ],
        "cc": [
          {
            "name": "Jane Smith",
            "email": "jane@acme.com",
            "linkedin_url": "https://linkedin.com/in/janesmith",
            "contact_id": "con_abc123",
            "company_name": "Acme Inc"
          }
        ],
        "bcc": [
          {
            "name": "Jane Smith",
            "email": "jane@acme.com",
            "linkedin_url": "https://linkedin.com/in/janesmith",
            "contact_id": "con_abc123",
            "company_name": "Acme Inc"
          }
        ],
        "subject": "Re: Demo follow-up",
        "timestamp": "2026-03-01T10:00:00Z"
      }
    ],
    "message_pagination": {
      "page": 1,
      "page_size": 25,
      "total_count": 142,
      "total_pages": 6
    }
  }
}

Changes