# `bird sms templates list`

## Usage

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

## Description

List the SMS templates available to your workspace, including Bird's built-in templates. Filter by scope, category, or language. The catalogue is small and returned in full; this list is not paginated. Use sms_templates_get to read one template's variables before sending with it.

## Examples

```bash
bird sms templates list
```

## Options

| Name                | Description                                                                                                                                                                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--category`        | Keep only templates whose category matches. Omit for all categories.                                                                                                                                                                       |
| `--language`        | Keep only templates available in this language, as a BCP-47 tag. Matches the template's available_languages entries exactly, with no fallback.                                                                                             |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                           |
| `--scope`           | Keep only templates of this scope: system for Bird's built-in templates, workspace for templates authored in your workspace. Omit for all. Workspace-authored SMS templates are not available yet, so workspace currently matches nothing. |

## Related

| Name                                                              | Description         |
| ----------------------------------------------------------------- | ------------------- |
| [`bird sms templates get`](/docs/cli/reference/sms-templates-get) | Get an SMS template |