---
title: "List email templates"
method: GET
path: "/accounts/email-templates"
tags: ["Email Templates"]
---

# List email templates

`GET /accounts/email-templates`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/accounts/email-templates`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/email-templates/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the account's email templates, without their bodies. `published` also returns templates that hold a published version and a draft.

## Query parameters

- `status` 'draft' | 'published' | 'published_with_draft'

## Response `200`

Success

- object
  - `data` EmailTemplateSummary[], required
    - `key` string
    - `name` string
    - `description` string
    - `status` 'draft' | 'published' | 'published_with_draft'
    - `tags` string[]
    - `data` EmailTemplateData: Record data a template merges. The caller loads it; a declared tag with no value renders blank.
      - `record_configs` string[]: Whole record sets by config id
      - `fields` string[]: Exact `<config id>.<payload path>` fields
    - `source` string
    - `created_at` string
    - `updated_at` string
    - `updated_by` string
    - `published_at` string
    - `published_by` string

## Other responses

- `401`: Unauthorized

## Changes

- **2026-11-12** `700eb1ace61a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/changes/accounts/email-templates/get.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/revisions/700eb1ace61a?raw)