---
title: "Search schedule emails"
method: POST
path: "/email/scheduled/search"
tags: ["EMAILS"]
---

# Search schedule emails

`POST /email/scheduled/search`

## Request

- Base URL: `https://api.smtp2go.com/v3`
- URL: `https://api.smtp2go.com/v3/email/scheduled/search`
- Auth: one of:
  - API key in header `X-Smtp2go-Api-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4/docs/email/scheduled/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Allows searching of scheduled emails

## Request body

- object
  - `schedule_id` string: The schedule_id returned from the `/email/send` endpoint
  - `search_subject` string: The subject of the email you want to search for
  - `search_recipient` string: The recipient of the email you want to search for
  - `search_sender` string: The sender of the email you want to search for
  - `limit` integer: If passed will limit the search results
  - `page` integer: If passed will return the results of the specific page

## Response `200`

Scheduled email results

- object[]
  - `schedule_id` string: A unique identifier for the scheduled_email
  - `schedule` string: A timestamp indicating when the email was scheduled. A total of 50,000 emails can be queued at any one time.
  - `sender` string: The sender of the scheduled email
  - `subject` string: The subject of the email
  - `recipients` string: The recipients the email is scheduled to send to
  - `client_ip` string: The IP address that scheduled the email.

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4.md) - [All operations](https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) - [OpenAPI document](https://skmtc.dev/smtp2go/apis/smtp2go-api-v3-0-4/revisions/313dcf9dd255?raw)