---
title: "Search"
method: POST
path: "/email/search"
tags: ["Emails"]
---

# Search

`POST /email/search`

Returns a list of emails that matched the search query. Allows getting only the first 10,000 results. To get all results please use scroll or download API endpoints. By default, search operations, which return a list of found items, return only the first 25 items. To get a different set of items, you can use the offset and limit parameters in the request body.

## Request body

- SearchEmailRequest
  - `limit` integer — The maximum number of items to return per page. Value must be in the range between 1 and 100.
  - `offset` integer — The offset of the item at which to begin the response. Value must be in the range between 1 and 9999.
  - `search_params` object[], required — A list of email attributes to filter the search results by. A comprehensive list of valid search parameters is shown in the table below.

## Response `200`

Operation successful

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/spyse/apis/data-api.md) · [All operations](https://skmtc.dev/spyse/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spyse/data-api/revisions/fd05b83ed2c5/schema)