---
title: "Search received emails"
method: POST
path: "/trigger/emails/search"
tags: ["Email triggers"]
---

# Search received emails

`POST /trigger/emails/search`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/trigger/emails/search`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-6/docs/trigger/emails/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Queries the account's email trigger index. Conditions are combined by `operator`, with paging and sorting set by `limit` and `sort_by`.

## Request body

- object
  - `limit` integer
  - `sort_by` string: Field to sort by
  - `operator` string: How conditions combine
  - `conditions` object[]

## Response `200`

Success

- object
  - `body` object
    - `results` object[]

## Other responses

- `400`: Bad request
- `401`: Unauthorized

## Changes

- **2026-11-12** `a9f443efdc5d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-6/changes/trigger/emails/search/post.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-6.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-6/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-6/revisions/a9f443efdc5d?raw)