# `bird email templates list`

## Usage

```bash
bird email templates list [flags]
```

## Description

List email templates as a cursor page, covering both the workspace's own templates and Bird's built-in `system` templates. Filter by scope, category, source, or a search across slug, name, and description.

Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after.

## Examples

```bash
bird email templates list
bird email templates list | jq -r '.data[].id'
bird email templates list --limit 50 --starting-after <cursor>
```

## Options

#### Filters

| Name                | Description                                                                                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--category`        | Filter by template category. Possible values: transactional, marketing.                                                                                      |
| `--q`               | A case-insensitive substring search across the template's slug, name, and description.                                                                       |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                             |
| `--scope`           | Filter by ownership tier — system for Bird's built-in templates, workspace for the workspace's own. Omit to return both. Possible values: system, workspace. |
| `--source`          | Filter by authoring format. Possible values: html.                                                                                                           |

#### Pagination

| Name               | Description                                                                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `--ending-before`  | Cursor from the prev_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. |
| `--limit <n>`      | Maximum number of items to return per page.                                                                                                    |
| `--starting-after` | Cursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.  |

## Related

| Name                                                                              | Description                                           |
| --------------------------------------------------------------------------------- | ----------------------------------------------------- |
| [`bird email templates create`](/docs/cli/reference/email-templates-create)       | Create an email template and its first editable draft |
| [`bird email templates delete`](/docs/cli/reference/email-templates-delete)       | Delete an email template                              |
| [`bird email templates duplicate`](/docs/cli/reference/email-templates-duplicate) | Duplicate an email template                           |
| [`bird email templates get`](/docs/cli/reference/email-templates-get)             | Get an email template                                 |
| [`bird email templates preview`](/docs/cli/reference/email-templates-preview)     | Render a template with sample values                  |
| [`bird email templates update`](/docs/cli/reference/email-templates-update)       | Update an email template                              |