---
title: "List emails"
method: GET
path: "/emails"
tags: ["Email"]
---

# List emails

`GET /emails`

Returns a list of emails

## Query parameters

- `subject` string
- `crm_account_id` string[]
- `deal_uuid` string[]
- `from_date_time` string, date-time
- `to_date_time` string, date-time
- `page` integer
- `size` integer

## Response `200`

emails successfully returned

- ListEmailsResponse
  - `data` Email[]
    - `messageId` string, required — The unique identifier of the email message.
    - `threadId` string, required — The unique identifier of the email thread or conversation.
    - `sendDate` string, date-time, required — The date and time when the email was sent.
    - `sender` string, required — The email address of the sender.
    - `recipients` string[], required — List of primary recipient email addresses.
    - `ccRecipients` string[], required — List of CC (carbon copy) recipient email addresses.
    - `subject` string, required — The subject line of the email.
    - `snippet` string, required — A brief preview or excerpt of the email body content.
    - `bodyUrl` string, required — URL endpoint to retrieve the full email body content.
    - `isInternalUser` boolean, required — Indicates whether the sender is an internal user within the organization.
  - `meta` Meta
    - `pageCount` integer
    - `totalRecords` integer
    - `pageNumber` integer
    - `pageSize` integer

## Other responses

- `401` — valid API key required
- `default` — unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)