---
title: "bird sms stats by-content-type"
description: "Get outbound SMS statistics by message type"
canonical: "https://bird.com/docs/cli/reference/sms-stats-by-content-type"
---

# `bird sms stats by-content-type`

## Usage

```bash
bird sms stats by-content-type [flags]
```

## Description

Compare SMS and MMS delivery counts, rates and latency. Omit content\_type for both; previously recorded counts remain attributed to SMS.

## Examples

```bash
bird sms stats by-content-type
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                                                            |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--content-type`    | Restrict statistics to SMS or MMS. Omit to include both. This filter can be combined with an existing dimension filter where the operation supports one. Previously recorded statistics remain attributed to SMS. New activity uses the message type, so a late MMS delivery can appear under MMS while its earlier send remains under SMS. Possible values: sms, mms. |
| `--from`            | Start date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted). Defaults to 30 days before to when omitted; with include\_trend=true and trend\_grain=hourly the default tightens to keep the window within the 720-hour trend cap.                                                                              |
| `--include-trend`   | When true, each row also carries a trend array: a short per-bucket lifecycle-count series for that row over the window. Returned only when limit is 50 or fewer and the window is at most 90 days (trend\_grain=daily) or 720 hours (trend\_grain=hourly); a larger request returns 422.                                                                               |
| `--limit <n>`       | Maximum number of message-type rows to return, ranked by the sort field descending. Allowed range: 1 to 200.                                                                                                                                                                                                                                                           |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                                                       |
| `--sort`            | Metric to rank rows by, applied descending. Any lifecycle count or derived rate in the response may be used; rows whose rate is undefined (zero denominator) sort last. Defaults to accepted. Possible values: accepted, sent, delivered, undelivered, failed, rejected, expired, delivery\_rate, failure\_rate.                                                       |
| `--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`              | End date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted). Defaults to today in that timezone when omitted. Window may not exceed 365 days.                                                                                                                                                                   |
| `--trend-grain`     | Bucket grain for the trend series. Has no effect unless include\_trend=true. Possible values: daily, hourly.                                                                                                                                                                                                                                                           |

## Related

| Name                                                                            | Description                                |
| ------------------------------------------------------------------------------- | ------------------------------------------ |
| [`bird sms stats by-carrier`](/docs/cli/reference/sms-stats-by-carrier)         | Get outbound SMS statistics by carrier     |
| [`bird sms stats by-category`](/docs/cli/reference/sms-stats-by-category)       | Get outbound SMS statistics by category    |
| [`bird sms stats by-cost-center`](/docs/cli/reference/sms-stats-by-cost-center) | Get outbound SMS statistics by cost center |
| [`bird sms stats by-country`](/docs/cli/reference/sms-stats-by-country)         | Get outbound SMS statistics by country     |
| [`bird sms stats by-error-code`](/docs/cli/reference/sms-stats-by-error-code)   | Get outbound SMS statistics by error code  |
| [`bird sms stats by-originator`](/docs/cli/reference/sms-stats-by-originator)   | Get outbound SMS statistics by originator  |
| [`bird sms stats by-status`](/docs/cli/reference/sms-stats-by-status)           | Get outbound SMS statistics by status      |
| [`bird sms stats by-tag`](/docs/cli/reference/sms-stats-by-tag)                 | Get outbound SMS statistics by tag         |
| [`bird sms stats daily`](/docs/cli/reference/sms-stats-daily)                   | Get daily outbound SMS statistics          |
| [`bird sms stats hourly`](/docs/cli/reference/sms-stats-hourly)                 | Get hourly outbound SMS statistics         |
| [`bird sms stats summary`](/docs/cli/reference/sms-stats-summary)               | Get aggregate outbound SMS statistics      |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)
