---
title: "List messages"
method: GET
path: "/3.0/conversations/{conversation_id}/messages"
tags: ["conversations"]
---

# List messages

`GET /3.0/conversations/{conversation_id}/messages`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/conversations/{conversation_id}/messages`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/conversations/:conversation_id/messages/get.ts> (a function with typed inputs; its response is checked against the schema)

Get messages from a specific conversation. Conversations has been deprecated in favor of Inbox and these endpoints don't include Inbox data. Past Conversations are still available via this endpoint, but new campaign replies and other Inbox messages aren’t available using this endpoint.

## Path parameters

- `conversation_id` string, required

## Query parameters

- `fields` string[]
- `exclude_fields` string[]
- `is_read` 'true' | 'false'
- `before_timestamp` string, date-time
- `since_timestamp` string, date-time

## Response `200`

- object: Messages from a specific conversation.
  - `_links` object[]: A list of link types and descriptions for the API schema documents.
    - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
    - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
    - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
    - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `conversation_id` string: A string that identifies this conversation.
  - `conversation_messages` object[]: An array of objects, each representing a conversation messages resources.
    - `_links` object[]: A list of link types and descriptions for the API schema documents.
      - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
      - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
      - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
      - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
    - `conversation_id` string: A string that identifies this message's conversation
    - `from_email` string: A label representing the email of the sender of this message
    - `from_label` string: A label representing the sender of this message
    - `id` string: A string that uniquely identifies this message
    - `list_id` integer: The list's web ID
    - `message` string: The plain-text content of the message
    - `read` boolean: Whether this message has been marked as read
    - `subject` string: The subject of this message
    - `timestamp` string, date-time: The date and time the message was either sent or received in ISO 8601 format.
  - `total_items` integer: The total number of items matching the query regardless of pagination.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

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