# List 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.

Endpoint: GET /beta/conversations/{conversationId}/messages
Version: beta
Security: ApiKeyAuth

## Path parameters:

  - `conversationId` (integer, required)

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string, required)

  - `data.authorId` (string, required)

  - `data.externalId` (string)

  - `data.createdAt` (string, required)

  - `data.attributes` (any, required)

  - `data.attributes.duration` (integer)

  - `data.attributes.recording` (string, required)

  - `data.attributes.content` (any)

  - `data.attributes.content.value` (string, required)

  - `data.attributes.direction` (string)
    values: [Inbound, Internal, Outbound]

  - `data.attributes.attachments` (array)

  - `data.attributes.attachments.url` (string, required)
    url

  - `data.attributes.attachments.prettyName` (string)

  - `data.attributes.isAutomated` (boolean, required)

  - `data.attributes.emailContent` (any)

  - `data.attributes.from` (object)

  - `data.attributes.from.email` (string, required)

  - `data.attributes.from.name` (string)

  - `data.attributes.replyDefaultToEmails` (array)

  - `data.attributes.to` (array)

  - `data.attributes.cc` (array)

  - `data.attributes.bcc` (array)

  - `data.attributes.isAutoReply` (boolean, required)

  - `data.attributes.inlineImages` (array)
    Files the sender embedded in the message body, such as the images that `emailContent` references. The sending email client decides whether a file is embedded or attached, so a file you would expect in `attachments` can arrive here instead. Read both fields to get every file on the message.

  - `data.attributes.attachments` (array)
    Files the sender attached to the message. Files the sender embedded in the message body are listed in `inlineImages` instead.

  - `data.attributes.deliveryFailureReason` (string)

  - `data.attributes.formSubmission` (object, required)

  - `data.attributes.utterance_start_ms` (integer)

  - `data.attributes.utterance_end_ms` (integer)

## Response 400 fields (application/json):

  - `message` (string, required)

## Response 404 fields (application/json):

  - `message` (string, required)