---
title: "Retrieve an email rule"
method: GET
path: "/v1/email-rules/{rule_id}"
tags: ["Email"]
---

# Retrieve an email rule

`GET /v1/email-rules/{rule_id}`

## Request

- Base URL: `https://api-eu.dynamicdocumentapi.com`
- URL: `https://api-eu.dynamicdocumentapi.com/v1/email-rules/{rule_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Common base: API key or OAuth only, never a dashboard region token.

## Path parameters

- `rule_id` string, required

## Response `200`

- EmailRule
  - `attach_formats` string[], required
  - `attachments` 'attach_or_link' | 'attach' | 'link' | 'none', required: * `attach_or_link` - Attach Or Link * `attach` - Attach * `link` - Link * `none` - None
  - `bcc` string, required
  - `cc` string, required
  - `condition` string, required
  - `connection_id` string, required
  - `created_at` string, date-time, required
  - `enabled` boolean, required
  - `from_email` string, nullable, required: null = the connection's default sender.
  - `from_name` string, required
  - `html` string, required
  - `id` string, required: `emr_…`
  - `name` string, required
  - `object` string
  - `position` integer, required: 0 to 4: the order the template's rules send in.
  - `provider_template` EmailProviderTemplate, required
    - `id` integer, required: The template's id in the Brevo account.
    - `params` string, required: Template source that must render to a JSON object (≤ 64 KiB).
  - `reply_to` string, required
  - `subject` string, required
  - `template_id` string, required
  - `text` string, required
  - `to` string, required
  - `updated_at` string, date-time, required
  - `warnings` EmailRuleWarning[]: On create and update responses.
    - `code` string, required: `email_sender_unverified`
    - `message` string, required
    - `path` string, required

## Other responses

- `401`: Missing, invalid, expired or revoked credentials.
- `403`: Insufficient scope, IP not allowed, workspace suspended or scheduled for deletion, or email not verified.
- `404`: Email rule not found.
- `429`: Rate limited (`Retry-After`).
- `503`: The control plane is unreachable (`Retry-After`).

---

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