---
title: "List conversations"
method: GET
path: "/3.0/conversations"
tags: ["conversations"]
---

# List conversations

`GET /3.0/conversations`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/conversations`
- 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/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of conversations for the account. 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.

## Query parameters

- `fields` string[]
- `exclude_fields` string[]
- `count` integer
- `offset` integer
- `has_unread_messages` 'true' | 'false'
- `list_id` string
- `campaign_id` string

## Response `200`

- object: A collection of this account's tracked conversations.
  - `_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.
  - `conversations` object[]: A list of conversations.
    - `_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.
    - `campaign_id` string: The unique identifier of the campaign for this 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 conversation.
    - `last_message` object: The most recent message in the 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.
      - `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.
    - `list_id` string: The unique identifier of the list for this conversation.
    - `message_count` integer: The total number of messages in this conversation.
    - `subject` string: The subject of the message.
    - `unread_messages` integer: The number of unread messages in this conversation.
  - `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)