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

# Get conversation

`GET /3.0/conversations/{conversation_id}`

## Request

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

Get details about an individual 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[]

## Response `200`

- object: Details about an individual conversation. Conversation tracking is a feature available to paid accounts that lets you view replies to your campaigns in your Mailchimp account.
  - `_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.

## 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)