---
title: "List or filter all Email activities"
method: GET
path: "/activity/email/"
tags: ["activities.emails"]
---

# List or filter all Email activities

`GET /activity/email/`

You'll get one object per email message.

## 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` EmailActivity[], required
    - `_type` string, required
    - `activity_at` string, date-time, nullable, required
    - `agent_action_reason` string, nullable
    - `agent_config_id` string, 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, required
    - `body_preview` string, nullable
    - `body_text` string, nullable, 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
  - `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)
