---
title: "List or filter all EmailThread activities"
method: GET
path: "/activity/emailthread/"
tags: ["activities.email_threads"]
---

# List or filter all EmailThread activities

`GET /activity/emailthread/`

You'll get one object per email conversation (generally grouped by subject).

## Query parameters

- `_limit` integer
- `_skip` integer
- `id__in` string[], nullable
- `lead_id` string[], nullable
- `contact_id` string[], nullable
- `user_id` string[], nullable
- `organization_id` string, nullable
- `_type` string[], nullable
- `date_created__gte` union
  - string, date-time
  - string, date
- `date_created__lte` union
  - string, date-time
  - string, date
- `date_created__gt` union
  - string, date-time
  - string, date
- `date_created__lt` union
  - string, date-time
  - string, date
- `activity_at__gte` union
  - string, date-time
  - string, date
- `activity_at__lte` union
  - string, date-time
  - string, date
- `activity_at__gt` union
  - string, date-time
  - string, date
- `activity_at__lt` union
  - string, date-time
  - string, date
- `_fields` string

## Response `200`

Successful response

- object
  - `data` EmailThreadActivity[], required
    - `_type` string, required
    - `activity_at` string, date-time, nullable, required
    - `comment_summary` CommentSummary
      - `comment_count` integer, required
      - `thread_id` string, required
    - `contact_id` string, nullable, required
    - `created_by` string, nullable, required
    - `created_by_name` string, nullable
    - `date_created` string, date-time, required
    - `date_updated` string, date-time, required
    - `emails` EmailInThread[]
      - `_type` string, required
      - `activity_at` string, date-time, nullable, required
      - `agent_action_reason` string, nullable
      - `agent_config_id` string, nullable
      - `ai_draft` object, nullable
      - `attachments` Attachment[], nullable
        - `content_type` string, nullable, required
        - `filename` string, nullable, required
        - `size` integer, nullable, required
        - `thumbnail_url` string, nullable
        - `url` string, required
      - `bcc` string[], required
      - `body_html` string, nullable
      - `body_html_quoted` QuotedEmailHTML[], nullable
        - `expand` boolean, required
        - `html` string, required
      - `body_preview` string, nullable
      - `body_text` string, nullable
      - `body_text_quoted` QuotedEmailText[], nullable
        - `expand` boolean, required
        - `text` string, required
      - `bulk_email_action_id` string, nullable, required
      - `cc` string[], required
      - `contact_id` string, nullable, required
      - `created_by` string, nullable, required
      - `created_by_name` string, nullable
      - `date_created` string, date-time, required
      - `date_scheduled` string, date-time, nullable, required
      - `date_sent` string, date-time, nullable, required
      - `date_updated` string, date-time, required
      - `direction` 'incoming' | 'outgoing', required — Direction of communication. Outgoing means the communication flowing from the user to the lead/contact. Inbound means the opposite.
      - `email_account_id` string, nullable
      - `envelope` object, nullable
      - `followup_sequence_add_cc_bcc` boolean, required
      - `followup_sequence_delay` integer, nullable, required
      - `followup_sequence_id` string, nullable
      - `has_reply` boolean, required
      - `id` string, required
      - `in_reply_to_id` string, nullable, required
      - `lead_id` string, nullable, required
      - `message_ids` string[], required
      - `need_smtp_credentials` boolean, required
      - `opens` EmailOpen[], nullable
        - `ip_address` string, nullable, required
        - `opened_at` string, date-time, required
        - `opened_by` string, nullable, required
        - `user_agent` string, nullable, required
      - `opens_summary` string, nullable, required
      - `organization_id` string, required
      - `references` string[], required
      - `send_as_id` string, nullable, required
      - `send_attempts` object[], nullable
      - `sender` string, nullable, required
      - `sequence_id` string, nullable
      - `sequence_name` string, nullable
      - `sequence_subscription_id` string, nullable
      - `status` 'inbox' | 'draft' | 'scheduled' | 'outbox' | 'sent' | 'error', required — Status of a message, such as Email or SMS.
      - `subject` string, nullable, required
      - `template_id` string, nullable, required
      - `template_name` string, nullable
      - `thread_id` string, nullable, required
      - `to` string[], required
      - `updated_by` string, nullable, required
      - `updated_by_name` string, nullable
      - `user_id` string, nullable, required
      - `user_name` string, nullable
      - `users` string[], required
    - `id` string, required
    - `importance` union
      - ImportantEmailThread
        - `reason` 'manual' | 'contains-manual-message' | 'most-recent-communication' | 'has-response' | 'whitelisted' | 'by-default' | 'unset-initial-default', required
        - `type` 'important', required
      - NotImportantEmailThread
        - `reason` 'manual' | 'scheduling-emails' | 'automated-outbound' | 'marketing-or-transactional' | 'by-default', required
        - `type` 'not_important', required
    - `latest_emails` EmailPreview[]
      - `bcc` string[], required
      - `body_preview` string, nullable, required
      - `cc` string[], required
      - `date_created` string, date-time, required
      - `date_sent` string, date-time, nullable, required
      - `date_updated` string, date-time, required
      - `direction` 'incoming' | 'outgoing', required — Direction of communication. Outgoing means the communication flowing from the user to the lead/contact. Inbound means the opposite.
      - `envelope` EmailEnvelope, required
        - `bcc` EmailIdentity[], required
          - `email` string, required
          - `name` string, required
        - `cc` EmailIdentity[], required
          - `email` string, required
          - `name` string, required
        - `date` string, nullable, required
        - `from` EmailIdentity[], required
          - `email` string, required
          - `name` string, required
        - `in_reply_to` string, nullable, required
        - `is_autoreply` boolean, required
        - `message_id` string, nullable, required
        - `reply_to` EmailIdentity[], required
          - `email` string, required
          - `name` string, required
        - `sender` EmailIdentity[], required
          - `email` string, required
          - `name` string, required
        - `subject` string, nullable, required
        - `to` EmailIdentity[], required
          - `email` string, required
          - `name` string, required
      - `has_attachments` boolean, nullable, required
      - `id` string, nullable, required
      - `opens_summary` string, nullable, required
      - `send_as_id` string, nullable, required
      - `sender` string, nullable, required
      - `status` 'inbox' | 'draft' | 'scheduled' | 'outbox' | 'sent' | 'error', required — Status of a message, such as Email or SMS.
      - `subject` string, nullable, required
      - `to` string[], required
      - `user_id` string, nullable, required
    - `latest_normalized_subject` string, nullable, required
    - `lead_id` string, nullable, required
    - `n_emails` integer, nullable, required
    - `organization_id` string, required
    - `participants` EmailIdentity[]
      - `email` string, required
      - `name` string, required
    - `summary` EmailThreadSummary
      - `expired_at` string, date-time, nullable, required
      - `feedback` EmailThreadSummaryFeedback
        - `detail` string, nullable, required
        - `given_at` string, date-time, required
        - `rating` 'positive' | 'negative', required
      - `generated_at` string, date-time, nullable, required
      - `status` 'pending' | 'success' | 'failure' | 'expired', required
      - `summary_html` string, nullable, required
      - `summary_text` string, nullable, required
      - `updated_at` string, date-time, required
    - `updated_by` string, nullable, required
    - `updated_by_name` string, nullable
    - `user_id` string, nullable, required
    - `user_name` string, nullable
    - `users` string[], required
  - `has_more` boolean, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)