> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monaco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Messages

> Returns conversation history of email and LinkedIn messages for a contact or account, merged into one recency-ordered feed.

Each row carries a conversation_id and channel. Pass both to get_conversation for the full thread.



## OpenAPI

````yaml https://api.monaco.com/openapi.json post /v1/messages/list
openapi: 3.1.0
info:
  title: Monaco Public API
  description: Public API for Monaco
  version: 1.0.0
servers:
  - url: https://api.monaco.com
security: []
paths:
  /v1/messages/list:
    post:
      tags:
        - Messages
      summary: Get Messages
      description: >-
        Returns conversation history of email and LinkedIn messages for a
        contact or account, merged into one recency-ordered feed.


        Each row carries a conversation_id and channel. Pass both to
        get_conversation for the full thread.
      operationId: get_messages
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessagesListRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessagesListResponse'
              example:
                data:
                  - conversation_id: thread_abc123
                    channel: email
                    direction: inbound
                    subject: Demo follow-up
                    preview: Thanks for the demo yesterday...
                    timestamp: '2026-03-01T10:00:00Z'
                    contact_id: con_abc123
                has_more: false
                meta:
                  timestamp: '2026-04-21T12:00:00Z'
        4XX:
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
components:
  schemas:
    MessagesListRequest:
      properties:
        contact_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Contact Id
          description: Scope to a single contact's message history
        account_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Account Id
          description: Scope to a single account's message history
        cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Cursor
          description: >-
            Opaque token from a previous response's next_cursor; omit for the
            first page
        channels:
          anyOf:
            - items:
                $ref: '#/components/schemas/ChannelType'
              type: array
            - type: 'null'
          title: Channels
          description: Channels to include; omit or null returns all channels
          examples:
            - - email
        page_size:
          type: integer
          maximum: 100
          minimum: 1
          title: Page Size
          default: 25
      type: object
      title: MessagesListRequest
    MessagesListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/MessageRow'
          type: array
          title: Data
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: Pass back as `cursor` to fetch the next page; null when done
        has_more:
          type: boolean
          title: Has More
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      type: object
      required:
        - data
        - has_more
      title: MessagesListResponse
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: PublicErrorResponse
    ChannelType:
      type: string
      enum:
        - email
        - linkedin
      title: ChannelType
    MessageRow:
      properties:
        conversation_id:
          type: string
          title: Conversation Id
          description: Thread/chat identifier; pass to get_conversation with channel
          examples:
            - thread_abc123
        channel:
          $ref: '#/components/schemas/ChannelType'
          description: Channel the message was sent over
        direction:
          $ref: '#/components/schemas/MessageDirection'
          description: >-
            Inbound, outbound, or internal; unknown when direction is not yet
            determined
        subject:
          anyOf:
            - type: string
            - type: 'null'
          title: Subject
          description: Subject line of the conversation
          examples:
            - Demo follow-up
        preview:
          type: string
          title: Preview
          description: Short preview of the most recent message
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: When the most recent message was sent (ISO 8601)
          examples:
            - '2026-03-01T10:00:00Z'
        contact_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Contact Id
          description: ID of the associated contact
          examples:
            - con_abc123
        account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Id
          description: ID of the associated account
          examples:
            - acc_abc123
      type: object
      required:
        - conversation_id
        - channel
        - direction
        - preview
        - timestamp
      title: MessageRow
    ResponseMeta:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: Server timestamp of the response
      type: object
      title: ResponseMeta
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - not_found
        message:
          type: string
          title: Message
          description: Human-readable error message
          examples:
            - Resource not found
      type: object
      required:
        - code
        - message
      title: ErrorDetail
    MessageDirection:
      type: string
      enum:
        - inbound
        - outbound
        - internal
        - unknown
      title: MessageDirection

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.