---
title: "List a template's email rules"
method: GET
path: "/v1/templates/{template_id}/email-rules"
tags: ["Email"]
---

# List a template's email rules

`GET /v1/templates/{template_id}/email-rules`

## Request

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

0 to 5 rules in `position` order. Rules are live configuration, not versioned with the template: an edit applies to renders submitted afterwards.

## Path parameters

- `template_id` string, required

## Response `200`

- EmailRuleList: Cursor-pagination envelope. Management lists are single-page today.
  - `data` EmailRule[], required
    - `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
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `object` string

## 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`: Template 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)