# `bird sms stats inbound summary`

## Usage

```bash
bird sms stats inbound summary [flags]
```

## Description

Total messages your numbers received over a period. For a breakdown use `bird sms stats inbound by-country`, `bird sms stats inbound by-operator`, or `bird sms stats inbound by-number`.

## Examples

```bash
bird sms stats inbound summary
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--compare`         | Set to previous_period to include the received-message count for the immediately preceding window of equal length. The response also includes the change between the two, so you can show '+X% vs last period' without a second request. Possible values: previous_period.                                                                                                                                                                                                                 |
| `--from`            | Inclusive start of the window, either a calendar day (YYYY-MM-DD) or an RFC 3339 instant rounded down to the hour. The form you use selects the grain the total is resolved at. Interpreted in timezone, or in UTC when timezone is omitted. Must use the same form as to. A numeric UTC offset (for example +05:45) is rejected when timezone is set; pass a calendar day or a Z instant instead. Defaults to 30 days before to for day windows, or 168 hours before to for hour windows. |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `--timezone`        | IANA timezone identifier used to group statistics, for example Asia/Kathmandu. The default is UTC. Day and hour boundaries, including the default window when from and to are omitted, follow this timezone. When this parameter is set, pass from and to as calendar days or Z instants instead of timestamps with explicit UTC offsets.                                                                                                                                                  |
| `--to`              | Inclusive end of the window, in the same form as from. Defaults to today, or the current hour for an hour window. A day window may not exceed 365 days and an hour window 720 hours.                                                                                                                                                                                                                                                                                                       |

## Related

| Name                                                                                      | Description                            |
| ----------------------------------------------------------------------------------------- | -------------------------------------- |
| [`bird sms stats inbound by-country`](/docs/cli/reference/sms-stats-inbound-by-country)   | Get inbound SMS statistics by country  |
| [`bird sms stats inbound by-number`](/docs/cli/reference/sms-stats-inbound-by-number)     | Get inbound SMS statistics by number   |
| [`bird sms stats inbound by-operator`](/docs/cli/reference/sms-stats-inbound-by-operator) | Get inbound SMS statistics by operator |
| [`bird sms stats inbound daily`](/docs/cli/reference/sms-stats-inbound-daily)             | Get daily inbound SMS statistics       |
| [`bird sms stats inbound hourly`](/docs/cli/reference/sms-stats-inbound-hourly)           | Get hourly inbound SMS statistics      |