---
title: "List inbound mail rules"
method: GET
path: "/api/emails/{address}/rules"
tags: ["Email"]
---

# List inbound mail rules

`GET /api/emails/{address}/rules`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/rules`
- Auth: HTTP bearer

List a mailbox's inbound filtering rules, in the priority order they are applied (first match wins).

## Path parameters

- `address` string, required

## Response `200`

Rule list

- object
  - `mailbox` string
  - `rules` MailRule[]
    - `id` string
    - `priority` integer: Lower runs first
    - `match_field` 'from' | 'to' | 'subject' | 'body'
    - `match_op` 'contains' | 'equals' | 'regex'
    - `match_value` string
    - `action` 'drop' | 'mark_read' | 'forward' | 'webhook_only' | 'label' | 'escalate'
    - `action_arg` string, nullable
    - `enabled` boolean
    - `created_at` string, date-time
  - `hint` string

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)