---
title: "List messages"
method: GET
path: "/beta/conversations/{conversationId}/messages"
tags: ["Conversations", "Messages"]
---

# List messages

`GET /beta/conversations/{conversationId}/messages`

Get all messages for a particular conversation by providing the conversation id. Note that messages in `ContactForm` conversations can have attributes of `"_type": "EmailAttributes"` if they are created through a webform, or `"_type": "ContactFormAttributes"` when created through a chat widget.

## Path parameters

- `conversationId` integer, required

## Response `200`

List of messages for a conversation sorted from oldest to newest

- ListMessagesOutput
  - `data` Message[]
    - `id` string, uuid, required
    - `authorId` string, uuid, required
    - `externalId` string
    - `createdAt` string, date-time, required
    - `attributes` union, required
      - CallRecordingAttributes
        - `duration` integer
        - `recording` string, required
      - ChatAttributes
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string
        - `isAutomated` boolean, required
      - ContactFormAttributes
        - `emailContent` union
          - Regular
            - `content` union, required
              - …
          - TooLarge
            - `file` File, required
              - …
        - `from` EmailContact
          - `email` string, required
          - `name` string
        - `replyDefaultToEmails` EmailContact[]
          - `email` string, required
          - `name` string
        - `to` EmailContact[]
          - `email` string, required
          - `name` string
        - `cc` EmailContact[]
          - `email` string, required
          - `name` string
        - `bcc` EmailContact[]
          - `email` string, required
          - `name` string
        - `isAutoReply` boolean, required
        - `inlineImages` File[]
          - `url` string, required — url
          - `prettyName` string
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string
        - `deliveryFailureReason` string
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `originalContentUrl` File
          - `url` string, required — url
          - `prettyName` string
      - EmailAttributes
        - `emailContent` union
          - Regular
            - `content` union, required
              - …
          - TooLarge
            - `file` File, required
              - …
        - `from` EmailContact, required
          - `email` string, required
          - `name` string
        - `to` EmailContact[]
          - `email` string, required
          - `name` string
        - `cc` EmailContact[]
          - `email` string, required
          - `name` string
        - `bcc` EmailContact[]
          - `email` string, required
          - `name` string
        - `isAutoReply` boolean, required
        - `inlineImages` File[]
          - `url` string, required — url
          - `prettyName` string
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string
        - `deliveryFailureReason` string
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `originalContentUrl` File
          - `url` string, required — url
          - `prettyName` string
      - FacebookMessengerAttributes
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string
      - GenericAttributes
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string
      - MessengerFormAttributes
        - `formSubmission` FormSubmission, required
          - `values` MapFormAttributeValue, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
      - PhoneAttributes
        - `from` string, required
        - `to` string, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `duration` integer
      - SmsAttributes
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string
      - TranscriptAttributes
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
        - `utterance_start_ms` integer
        - `utterance_end_ms` integer
        - `direction` string — values: [Inbound, Internal, Outbound]
      - TwitterAttributes
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string
      - WhatsAppAttributes
        - `content` union
          - Html
            - `value` string, required
          - Markdown
            - `value` string, required
          - Text
            - `value` string, required
        - `direction` string — values: [Inbound, Internal, Outbound]
        - `attachments` File[]
          - `url` string, required — url
          - `prettyName` string

## Other responses

- `400` — Invalid value for: path parameter conversationId, Invalid value extracted from request context
- `404` — An entity in this request could not be found

---

[API](https://skmtc.net/dixa/apis/dixa-api.md) · [All operations](https://skmtc.net/dixa/apis/dixa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dixa/dixa-api/versions/041e058483f0/schema)