---
title: "Get Marketing Emails"
method: GET
path: "/ai/api/v1/marketing/emails"
tags: ["Marketing - Email"]
---

# Get Marketing Emails

`GET /ai/api/v1/marketing/emails`

## Request

- Base URL: `https://sharksapi.ai`
- URL: `https://sharksapi.ai/ai/api/v1/marketing/emails`
- Auth: HTTP bearer

Retrieve emails from inbox with optional filters. Returns email list with full content and metadata.

## Query parameters

- `folder` string
- `unread_only` boolean
- `from` string, email
- `subject_contains` string
- `limit` integer

## Response `200`

List of emails with full content

- object
  - `count` integer: Number of emails returned
  - `emails` object[]
    - `id` string
    - `from` string
    - `to` string
    - `subject` string
    - `date` string
    - `seen` boolean
    - `body` string
    - `size` integer

## Other responses

- `400`: Bad request - No active email connection found
- `500`: Server error - Failed to retrieve emails

---

[API](https://skmtc.dev/sharksapi/apis/sharksapi-ai-complete-api.md) · [All operations](https://skmtc.dev/sharksapi/apis/sharksapi-ai-complete-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sharksapi/apis/sharksapi-ai-complete-api/revisions/7e956273a359?raw)