---
title: "List email history for the enterprise portal"
method: GET
path: "/app/{app_id}/enterprise-portal/email-history"
tags: ["enterprisePortal"]
---

# List email history for the enterprise portal

`GET /app/{app_id}/enterprise-portal/email-history`

## Request

- Base URL: `https://api.replicated.com/vendor/v3`
- URL: `https://api.replicated.com/vendor/v3/app/{app_id}/enterprise-portal/email-history`
- Auth: API key in header `Authorization`

Returns a paginated list of emails sent through the enterprise portal with their delivery status.

Required RBAC Policy:
kots/app/{app_id}/enterprise-portal/email-history/read

## Path parameters

- `app_id` string, required

## Query parameters

- `emailType` string
- `status` string
- `customerId` string
- `limit` integer
- `offset` integer

## Response `200`

- object
  - `emails` EmailHistoryItem[]
    - `bounceType` string
    - `customerId` string
    - `customerName` string
    - `emailType` string
    - `fromEmail` string
    - `latestEventAt` string, date-time
    - `latestStatus` string
    - `messageId` string
    - `sentAt` string, date-time
    - `subject` string
    - `templateName` string
    - `toEmail` string
  - `total` integer

## Other responses

- `400`: Returned on bad input
- `401`: Return if the caller is not authorized
- `403`: Returned if the caller does not have the needed permission
- `404`: Returned on resource not found

## Changes

- **2026-11-03** `a36c6aead22f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/replicated/apis/vendor-api-v3-2/changes/app/:app_id/enterprise-portal/email-history/get.md)

---

[API](https://skmtc.dev/replicated/apis/vendor-api-v3-2.md) - [All operations](https://skmtc.dev/replicated/apis/vendor-api-v3-2/llms.txt) - [OpenAPI document](https://skmtc.dev/replicated/apis/vendor-api-v3-2/revisions/a36c6aead22f?raw)