---
title: "List forwarding rules"
method: GET
path: "/v1/email/forwarding"
tags: ["Email"]
---

# List forwarding rules

`GET /v1/email/forwarding`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/email/forwarding`
- Auth: API key in header `x-api-key`

Returns every inbound email forwarding rule in the order inbound mail is matched against them: highest priority first, then an exact address before a wildcard pattern at equal priority, then oldest first. The first rule that matches is the one that forwards. Filtering by domain returns that domain's rules and the rules that apply to every domain (domainId null). An organization holds at most 100, so the list is never paged.

## Query parameters

- `domainId` string
- `isActive` string, nullable

## Response `200`

ForwardingRuleList

- ForwardingRuleList
  - `items` object[], required
    - `id` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `domainId` string, required
    - `sourcePattern` string, nullable, required
    - `forwardTo` string[], required
    - `preserveHeaders` boolean, required
    - `priority` integer, required
    - `isActive` boolean, required
    - `forwardCount` integer, required
    - `failureCount` integer, required
    - `lastForwardedAt` string, nullable, required
    - `createdAt` string, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

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