# `bird sms keyword-rules list`

## Usage

```bash
bird sms keyword-rules list [flags]
```

## Description

List the default and workspace keyword rules that apply to inbound messages, most specific first. Filter by `country`, `number`, `operation`, or `scope`. Pass `number` to see one number's rules in evaluation order. Default coverage varies by country.

## Examples

```bash
bird sms keyword-rules list
```

## Options

| Name                | Description                                                                                                                                                                                                 |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--country`         | Keep only rules that apply in this country, as an ISO 3166-1 alpha-2 code. Omit for every country the default catalog covers, plus your own rules.                                                          |
| `--from-country`    | The country a sender is messaging from, as an ISO 3166-1 alpha-2 code. Use it with number to see what someone in that country gets, which can differ from what a local sender gets. Ignored without number. |
| `--number`          | Keep only the rules that apply to this number of yours, in E.164 format or as a short code, ordered the way they are applied to an inbound message.                                                         |
| `--operation`       | Keep only rules for this operation. Omit for all of them. Known values: stop, start, help, custom (others may exist).                                                                                       |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                            |
| `--scope`           | Keep only default rules (system) or only the rules you created (workspace). Omit for both. Possible values: system, workspace.                                                                              |

## Related

| Name                                                                            | Description                |
| ------------------------------------------------------------------------------- | -------------------------- |
| [`bird sms keyword-rules create`](/docs/cli/reference/sms-keyword-rules-create) | Create an SMS keyword rule |
| [`bird sms keyword-rules delete`](/docs/cli/reference/sms-keyword-rules-delete) | Delete an SMS keyword rule |
| [`bird sms keyword-rules get`](/docs/cli/reference/sms-keyword-rules-get)       | Get an SMS keyword rule    |
| [`bird sms keyword-rules update`](/docs/cli/reference/sms-keyword-rules-update) | Update an SMS keyword rule |