---
title: "Retrieve an Email Thread from a Specified Workflow"
method: GET
path: "/workflows/{id}/emails/{emailThreadId}"
tags: ["Workflows"]
---

# Retrieve an Email Thread from a Specified Workflow

`GET /workflows/{id}/emails/{emailThreadId}`

List a single email thread for a specified workflow. 

**OAuth Scope required:** `public.workflows.readEmailCommunications`

## Path parameters

- `id` string, required
- `emailThreadId` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Response `200`

GET Email Response

- union — A email-type item on the workflow activity feed
  - object — An inbound email-type item on the workflow activity feed
    - `type` 'inboundEmail', required — The type of the email-type activity feed item
    - `id` string, required — Unique ID of the email-type activity feed item
    - `emailThreadId` string, required — Unique ID of the email thread
    - `timestamp` string, required — The timestamp of the email (ISO8601 format)
    - `author` union, required — The author of an activity feed item
      - object — An internal author of an activity feed item
        - `type` 'internalUser', required — The type of author
        - `companyName` string, required — The company name of the author
        - `displayName` string — The display name of the author
        - `email` string — The email of the author
        - `userId` string — The user ID of the author
      - object — An external author of an activity feed item (typically a counterparty)
        - `type` 'externalUser', required — The type of author
        - `companyName` string, required — The company name of the author
        - `displayName` string — The display name of the author
        - `email` string — The email of the author
      - object — An integration author of an activity feed item
        - `type` 'integration', required — The type of author
        - `displayName` string, required — The display name of the integration
      - object — A system author of an activity feed item
        - `type` 'system', required — The type of author
        - `displayName` 'Ironclad', required — The display name of the system
    - `subject` string — The subject line of the email
    - `body` string — The body of the email (may include control characters)
    - `attachments` InboundEmailAttachment[] — The attachments on the email
      - `filename` string, required — The name of the attachment file
      - `download` string, required — The public API URL to download the attachment (does not include the base URL)
      - `content-type` string — The content type of the attachment
      - `documentKey` string — The document key of the associated document when the attachment has been added to the workflow. Will only be present when the "Add to Workflow" button has been clicked on the activity feed item.
      - `documentVersion` number — The version of the associated document when the attachment has been added to the workflow. Will only be present when the "Add to Workflow" button has been clicked on the activity feed item.
  - object — An outbound email-type item on the workflow activity feed
    - `type` 'outboundEmail', required — The type of the email-type activity feed item
    - `id` string, required — Unique ID of the email-type activity feed item
    - `timestamp` string, required — The timestamp of the email (ISO8601 format)
    - `author` union, required — The author of an activity feed item
      - object — An internal author of an activity feed item
        - `type` 'internalUser', required — The type of author
        - `companyName` string, required — The company name of the author
        - `displayName` string — The display name of the author
        - `email` string — The email of the author
        - `userId` string — The user ID of the author
      - object — An external author of an activity feed item (typically a counterparty)
        - `type` 'externalUser', required — The type of author
        - `companyName` string, required — The company name of the author
        - `displayName` string — The display name of the author
        - `email` string — The email of the author
      - object — An integration author of an activity feed item
        - `type` 'integration', required — The type of author
        - `displayName` string, required — The display name of the integration
      - object — A system author of an activity feed item
        - `type` 'system', required — The type of author
        - `displayName` 'Ironclad', required — The display name of the system
    - `subject` string — The subject line of the email
    - `body` string — The body of the email (may include control characters)
    - `attachments` OutboundEmailAttachment[] — The attachments on the email
      - `filename` string — The name of the attachment file
      - `download` string, required — The public API URL to download the attachment (does not include the base URL)
      - `content-type` string — The content type of the attachment
      - `documentKey` string, required — The document key of the associated document.
      - `documentVersion` number, required — The version of the associated document.
    - `recipients` string[] — The recipient email addresses for the email
    - `cc` string[] — The CC email addresses for the email
    - `emailOpenedTimestamps` object[] — The timestamps of when the email was opened by each recipient
      - `email` string, email, required — The email address of the recipient
      - `opened` boolean, required — Whether or not the email was opened by the recipient
      - `timestamp` string — The timestamp of when the email was opened (ISO 8601 format)

## Other responses

- `404` — 404 not found

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)