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

# `bird sms stats by-cost-center`

## Usage

```bash
bird sms stats by-cost-center [flags]
```

## Description

SMS delivery and latency stats grouped by the `cost_center` messages were sent with, ranked by the `sort` metric (default `accepted`) and capped by `limit` (default 50, maximum 200). Messages sent without a cost center are not counted, so rows do not sum to the period total.

## Examples

```bash
bird sms stats by-cost-center
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--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 cost center 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-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

- [Sending your first SMS](/learn/sms/sending-your-first-sms) (video)
- [What does SMS mean?](/explained/sms/what-does-sms-mean) (answer)
- [SMS](/sms-api) (product)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=sms)