---
title: "List Emails"
method: GET
path: "/v1/projects/emails"
tags: ["Emails"]
---

# List Emails

`GET /v1/projects/emails`

List emails (conversations) for a project. Returns lightweight metadata including subject, status, and screenshot URL.

## Query parameters

- `projectId` string, required
- `limit` integer
- `page` integer
- `status` 'pending' | 'processing' | 'completed' | 'failed'
- `search` string

## Response `200`

List of emails

- object
  - `success` boolean, required
  - `data` object, nullable
    - `emails` ListEmailsEmail[]
      - `conversationId` string — The conversation ID
      - `title` string — Conversation title (truncated prompt)
      - `subject` string, nullable — Email subject line
      - `previewText` string, nullable — Email preview text
      - `status` 'pending' | 'processing' | 'completed' | 'failed' — Generation status
      - `screenshotUrl` string, nullable — Email screenshot URL
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `pagination` object
      - `total` integer — Total number of emails
      - `page` integer — Current page number
      - `limit` integer — Results per page
      - `hasMore` boolean — Whether more results exist
  - `error` string, nullable

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `403` — Forbidden — no access to this project

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/versions/3f3dba69574b/schema)