---
title: "Get all emails based on filters"
method: POST
path: "/v1/unified-inbox/emails"
tags: ["unified-inbox"]
---

# Get all emails based on filters

`POST /v1/unified-inbox/emails`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/unified-inbox/emails`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/unified-inbox/emails/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- EmailsFilterDto
  - `page` number, required
  - `limit` number, required
  - `search` string
  - `categoryIds` string[]
  - `sentiment` 'Positive' | 'Negative' | 'Neutral' | 'Uncategorized': Filter by SentimentsType
  - `sequenceIds` string[]
  - `emailAccountIds` string[]
  - `startDate` string
  - `endDate` string
  - `isRead` number
  - `owners` string[], required
  - `clientIds` string[]
  - `type` 'system' | 'external': Filter by emails type

## Response `200`

Successfully fetched email list

## Other responses

- `400`: 5001: Internal server error, please try again later<br><br>
- `500`: 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)