---
title: "Get Email Threads"
method: GET
path: "/api/email/threads"
tags: ["email"]
---

# Get Email Threads

`GET /api/email/threads`

## 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/email/threads`
- Auth: none declared

## Query parameters

- `page` integer
- `page_size` integer
- `mailbox_id` integer, nullable
- `deal_id` integer, nullable
- `associated` boolean, nullable
- `q` string, nullable

## Response `200`

OK

- EmailThreadListSchema
  - `items` EmailThreadSchema[], required
    - `id` integer, required
    - `mailbox_id` integer, required
    - `mailbox_email` string, required
    - `subject` string, required
    - `snippet` string, required
    - `participant_emails` string[], required
    - `deal_id` integer, nullable
    - `deal_label` string, nullable
    - `customer_name` string, nullable
    - `association_source` string, nullable
    - `visibility` 'shared' | 'private', required
    - `last_message_at` string, date-time, nullable
    - `message_count` integer, required
    - `has_attachments` boolean, required
    - `messages` EmailMessageSchema[], required
      - `id` integer, required
      - `subject` string, required
      - `snippet` string, required
      - `from_participants` EmailParticipantSchema[], required
        - `name` string, required
        - `email` string, required
      - `to_participants` EmailParticipantSchema[], required
        - `name` string, required
        - `email` string, required
      - `cc_participants` EmailParticipantSchema[], required
        - `name` string, required
        - `email` string, required
      - `direction` string, required
      - `is_read` boolean, required
      - `is_draft` boolean, required
      - `sent_from_hvacos` boolean, required
      - `has_attachments` boolean, required
      - `message_time` string, date-time, required
      - `attachments` EmailAttachmentSchema[], required
        - `id` integer, required
        - `filename` string, required
        - `content_type` string, required
        - `size` integer, nullable
        - `is_inline` boolean, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

---

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