---
title: "Changes to List mail messages associated with a deal"
method: GET
path: "/deals/{id}/mailMessages"
---

# Changes to List mail messages associated with a deal

`GET /deals/{id}/mailMessages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 30 revisions.

- **2026-10-21** `16a59954e145`: 10 breaking
- **2026-08-06** `bf863a979545`: 2 info
- **2025-04-29** `5c2800de8edb`: 2 info
- **2022-10-07** `5f19f075613e`: 3 breaking
- **2022-06-27** `1e06ebc0f11e`: 1 warning, 12 info

## Changes

- **2026-10-21** `16a59954e145`: 10 breaking
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/bcc/items/linked_person_id` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/bcc/items/linked_person_name` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/cc/items/linked_person_id` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/cc/items/linked_person_name` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/draft` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/from/items/linked_person_id` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/from/items/linked_person_name` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/to/items/linked_person_id` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/to/items/linked_person_name` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/data/allOf[subschema #2]/template_id` became nullable for the status `200`
- **2026-08-06** `bf863a979545`: 2 info
  - added the new optional `query` request parameter `include_body`
  - added the optional property `allOf[subschema #2]/data/items/data/allOf[subschema #1: MailMessageData]/body` to the response with the `200` status
- **2025-04-29** `5c2800de8edb`: 2 info
  - added `subschema #1: MailMessageData` to the `allOf[subschema #2]/data/items/data` response property `allOf` list for the response status `200`
  - removed `subschema #1` from the `allOf[subschema #2]/data/items/data` response property `allOf` list for the response status `200`
- **2022-10-07** `5f19f075613e`: 3 breaking
  - the `allOf[subschema #2]/data/items/data/allOf[subschema #1]/add_time` response's property format changed from `date` to `date-time` for status `200`
  - the `allOf[subschema #2]/data/items/data/allOf[subschema #1]/message_time` response's property format changed from `date` to `date-time` for status `200`
  - the `allOf[subschema #2]/data/items/data/allOf[subschema #1]/update_time` response's property format changed from `date` to `date-time` for status `200`
- **2022-06-27** `1e06ebc0f11e`: 1 warning, 12 info
  - removed the optional property `allOf[subschema #2]/data/items/data/allOf[subschema #1]/write_flag` from the response with the `200` status
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`
  - the `` response's property default value changed from `1` to `0` for the status `200`

---

[Operation](https://skmtc.dev/pipedrive/apis/pipedrive-api-v1/docs/deals/:id/mailMessages/get.md) - [API](https://skmtc.dev/pipedrive/apis/pipedrive-api-v1.md) - [Page](https://skmtc.dev/pipedrive/apis/pipedrive-api-v1/changes/deals/:id/mailMessages/get)