---
title: "Get Deal Mail Messages"
method: GET
path: "/api/communications/deals/{deal_id}/mail-messages"
tags: ["communications"]
---

# Get Deal Mail Messages

`GET /api/communications/deals/{deal_id}/mail-messages`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/communications/deals/{deal_id}/mail-messages`
- Auth: none declared

## Path parameters

- `deal_id` integer, required

## Response `200`

OK

- GetDealMailMessagesResponse
  - `success` boolean, required: Response success flag
  - `data` MailMessageItem[], nullable, required: List of mail messages
    - `object` string, required: Type of this item
    - `timestamp` string, date-time, required: When item was created
    - `data` MailMessageData, required: Full mail‐message data
      - `id` integer, required: ID of the mail message
      - `from_` MailMessageParticipant[], required: The array of mail message senders
        - `id` integer, required: ID of the mail participant
        - `email_address` string, required: Mail address of the mail participant
        - `name` string, required: Name of the mail participant
        - `linked_person_id` integer, nullable, required: ID of the linked person to the mail message
        - `linked_person_name` string, nullable, required: Name of the linked person to the mail message
        - `mail_message_party_id` integer, nullable, required: ID of the mail message participant
      - `to` MailMessageParticipant[], required: The array of mail message recipients
        - `id` integer, required: ID of the mail participant
        - `email_address` string, required: Mail address of the mail participant
        - `name` string, required: Name of the mail participant
        - `linked_person_id` integer, nullable, required: ID of the linked person to the mail message
        - `linked_person_name` string, nullable, required: Name of the linked person to the mail message
        - `mail_message_party_id` integer, nullable, required: ID of the mail message participant
      - `cc` MailMessageParticipant[], required: The array of CC recipients
        - `id` integer, required: ID of the mail participant
        - `email_address` string, required: Mail address of the mail participant
        - `name` string, required: Name of the mail participant
        - `linked_person_id` integer, nullable, required: ID of the linked person to the mail message
        - `linked_person_name` string, nullable, required: Name of the linked person to the mail message
        - `mail_message_party_id` integer, nullable, required: ID of the mail message participant
      - `bcc` MailMessageParticipant[], required: The array of BCC recipients
        - `id` integer, required: ID of the mail participant
        - `email_address` string, required: Mail address of the mail participant
        - `name` string, required: Name of the mail participant
        - `linked_person_id` integer, nullable, required: ID of the linked person to the mail message
        - `linked_person_name` string, nullable, required: Name of the linked person to the mail message
        - `mail_message_party_id` integer, nullable, required: ID of the mail message participant
      - `body_url` string, required: The mail message body URL
      - `account_id` string, required: The connection account ID
      - `user_id` integer, required: ID of the user to whom this mail message is assigned
      - `mail_thread_id` integer, required: ID of the mail thread
      - `subject` string, required: The subject of the mail message
      - `body` string, nullable: The body of the mail message
      - `snippet` string, required: A short snippet of the mail message body
      - `mail_tracking_status` string, nullable: The mail‐tracking status (`null` if tracking not enabled)
      - `mail_link_tracking_enabled_flag` integer: Whether link tracking is enabled (0 or 1)
      - `read_flag` integer: Whether the mail message is read or not (0 or 1)
      - `draft` string, nullable: If draft, the JSON‐formatted mail object; otherwise `null`
      - `draft_flag` integer: Whether the mail message is a draft (0 or 1)
      - `synced_flag` integer: Whether synced with provider (0 or 1)
      - `deleted_flag` integer: Whether deleted (0 or 1)
      - `has_body_flag` integer: Whether has a body (0 or 1)
      - `sent_flag` integer: Whether sent (0 or 1)
      - `sent_from_pipedrive_flag` integer: Whether sent via Pipedrive (0 or 1)
      - `smart_bcc_flag` integer: Whether created via Smart BCC (0 or 1)
      - `message_time` string, date-time, required: When the message was sent or received
      - `add_time` string, date-time, required: When inserted into the database
      - `update_time` string, date-time, required: When last updated in the database
      - `has_attachments_flag` integer: Whether has attachments (0 or 1)
      - `has_inline_attachments_flag` integer: Whether has inline attachments (0 or 1)
      - `has_real_attachments_flag` integer: Whether has non-inline attachments (0 or 1)
  - `additional_data` AdditionalDataV1
    - `pagination` Pagination, required
      - `start` integer, required: Pagination start
      - `limit` integer, required: Items per page
      - `more_items_in_collection` boolean, required: Whether more items exist beyond this page
    - `filesCountByDay` unknown[], nullable
      - unknown

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)