---
title: "View and search sent emails"
method: POST
path: "/email/search"
tags: ["EMAILS"]
deprecated: true
---

# View and search sent emails

`POST /email/search`

> **Deprecated.**

Retrieve a list of up to 5,000 sent emails matching the supplied parameters.<br><br>The filter_query field can be used to create complex filters to make your searching more efficient. Find full details in the Email and Email Archive Guide.<br><br><strong>Note:<strong> Allow around two minutes after delivery for recently sent emails to be included in a search result.<br /><br />This endpoint is deprecated and will not be accessible in future API versions. Please use the <a href='https://developers.smtp2go.com/reference/search-activity'>Activity Search</a> endpoint instead.<i>This endpoint is rate-limited to 20 requests per minute.</i>

## Request body

- object
  - `start_date` string — ISO-8601 formatted datetime. Results will be inclusive of this value. Timezone is UTC. Defaults to current date at midnight.
  - `end_date` string — ISO-8601 formatted datetime. Results will be inclusive of this value. Timezone is UTC. Defaults to current time.
  - `limit` integer — The maximum number of emails to return. Enter an integer between 1 and 5,000. Defaults to 5,000.
  - `status_counts` boolean — If true, will return an object with counts of each unique email status
  - `opened_only` boolean — If true, will return emails that have been opened by at least one recipient.<br><br><strong>Note:</strong> Only returns information for emails sent from suitable accounts with Open Tracking enabled. See more info at <a href="https://support.smtp2go.com/hc/en-gb/articles/360003124714">Open Tracking</a>
  - `clicked_only` boolean — If true, will return emails that have had a link clicked by at least one recipient.<br><br><strong>Note:</strong> Only returns information for emails sent from suitable accounts with Click Tracking enabled. See more info at <a href="https://support.smtp2go.com/hc/en-gb/articles/900002237106-Click-Tracking">Click Tracking</a>
  - `ignore_case` boolean — If true, all string searches will be case insensitive
  - `filter_query` string — If passed, will return results filtered by these search parameters. The query format is documented below
  - `email_id` string[] — If passed, will only return emails with an ID contained within this array
  - `username` string — If passed, will only return emails sent by this user
  - `headers` string[] — If passed, will return the specified email header values
  - `continue_token` string — If passed, the resulting query will paginate from the previous query

## Response `200`

List of sent emails

- object
  - `request_id` string
  - `data` object
    - `count` integer
    - `emails` object[]
      - `sender` string
      - `email_id` string
      - `smtpcode` integer
      - `response` string
      - `process_status` string — The current status in the deliver process. Can be completed, processing, or rejected.
      - `host` string
      - `recipient` string
      - `delivered_at` string
      - `opens` object[]
        - `user_agent` string
        - `opened_at` string
        - `read_secs` string
        - `recipient` string
        - `ip_address` string
      - `total_opens` integer
      - `status` string — The status of the email, can be any of [processed, bounce, delivered, unsubscribed, spam, deferred, opened, refused, cancelled]
      - `email_ts` string
    - `continue_token` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/revisions/1ba6b25eebb9/schema)