---
title: "Email History"
method: GET
path: "/v1.0/communication/email"
tags: ["Communication"]
---

# Email History

`GET /v1.0/communication/email`

Returns email history entries for the given lead. Lead must belong to the caller's team.

## Query parameters

- `leadId` integer, required
- `offset` integer
- `limit` integer
- `currentId` integer

## Headers

- `Authorization` string, required

## Response `200`

Email history entries for the lead.

- CommunicationEmailListResponse — Wrapped response for GET /v1.0/communication/email. Email history entries are returned under the 'emails' key.
  - `emails` EmailResponse[] — Email history entries.
    - `id` integer — The ID of the email
    - `leadId` integer — The lead(Id) associated with the email
    - `direction` string — Outbound or Inbound email
    - `agentId` integer — The related Agent ID
    - `eventType` string — Sent, Opened or Bounced event
    - `emailEventTime` string — The event time of the email
    - `emailType` string — Manual or Auto email
    - `emailSubject` string — The subject of the email
    - `fromPond` boolean — Is the email sent from the lead pond

## Other responses

- `401` — Missing or invalid authentication token.
- `404` — Lead does not exist or is outside the caller's team (20006 LEAD_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)