---
title: "Search messages by to, from, and subject"
method: GET
path: "/inbox-search"
tags: ["Messages"]
---

# Search messages by to, from, and subject

`GET /inbox-search`

Search all account messages within the the `to` and `from` `.address` fields, and the
`subject` line. This differs from `/api/inbox-filter` by using logical OR, rather than AND
in `/api/inbox-filter`.

A maximum of 100 results will ever be returned. Refine the query or reduce the number of messages
in the account to find specific items.

## Response `200`

Query and search results

- object
  - `query` string
  - `messages` EmailMessageListShort[]
    - EmailMessageShort[] — List of condensed email message objects
      - `inbox` Inbox — unresolved $ref
      - `to` To — unresolved $ref
      - `from` From — unresolved $ref
      - `subject` Subject — unresolved $ref
      - `originalInbox` OriginalInbox — unresolved $ref
      - `size` Size — unresolved $ref
      - `attachments` Attachments — unresolved $ref
      - `received` Received — unresolved $ref
      - `bcc` Bcc — unresolved $ref
      - `cc` Cc — unresolved $ref
      - `domain` Domain — unresolved $ref
      - `folder` Folder — unresolved $ref
      - `ip` Ip — unresolved $ref
      - `labels` Labels — unresolved $ref
      - `links` Links — unresolved $ref
      - `read` Read — unresolved $ref
      - `rtls` Rtls — unresolved $ref
      - `savedBy` SavedBy — unresolved $ref
      - `spam` Spam — unresolved $ref
      - `via` Via — unresolved $ref

## Other responses

- `401` — Not authorized. You may need to log in first.

---

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