# `bird sms list-events`

## Usage

```bash
bird sms list-events <message-id> [flags]
```

## Description

The lifecycle event timeline for one SMS, oldest first: what happened to it and when. Filter with `type` (for example `sms.delivered`) to keep one kind of event. Use `bird sms get` for the message's current state and `bird sms list` to find its ID.

## Examples

```bash
bird sms list-events <message-id>
```

## Options

| Name                | Description                                                |
| ------------------- | ---------------------------------------------------------- |
| `--response-schema` | Print the fields this command returns, then exit           |
| `--type`            | Filter by event type, such as sms.delivered or sms.failed. |

## Related

| Name                                            | Description                          |
| ----------------------------------------------- | ------------------------------------ |
| [`bird sms get`](/docs/cli/reference/sms-get)   | Get an SMS message                   |
| [`bird sms list`](/docs/cli/reference/sms-list) | List SMS messages                    |
| [`bird sms send`](/docs/cli/reference/sms-send) | Send an SMS message to one recipient |