---
title: "Filter messages in account by to, from, and/or subject"
method: GET
path: "/inbox-filter"
tags: ["Messages"]
---

# Filter messages in account by to, from, and/or subject

`GET /inbox-filter`

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

At least one query condition is required, otherwise a 400 will be returned.

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
  - `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)