Source: https://cli.nylas.com/docs/commands/deliverability-send-events-timeseries

# nylas deliverability send-events timeseries

Show send counts and rates per day, week, or month.

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published November 3, 2026

Updated November 3, 2026

## What does nylas deliverability send-events timeseries do?

The nylas deliverability send-events timeseries command shows send counts and bounce and complaint rates per day, week, or month across a window of up to 365 days. It covers only messages sent from an Agent Account or through Transactional send; messages from connected grants such as Google or Microsoft accounts are not included. Use --granularity auto to pick day, week, or month from the window length.

## Usage

```bash
nylas deliverability send-events timeseries [--granularity auto|day|week|month] [--start YYYY-MM-DD] [--end YYYY-MM-DD] [--json]
```

## Flags

| Flag | Description |
| --- | --- |
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
| --end | Last UTC day, YYYY-MM-DD, inclusive (default: today) |
| --granularity | Bucket size: auto, day, week, month (default auto: day ≤21 days, week ≤92, else month) |
| --sending-domain | Only this sending domain |
| --start | First UTC day, YYYY-MM-DD (default: 6 days before --end) |

## Examples

The nylas deliverability send-events timeseries command shows send counts and bounce and complaint rates per day, week, or month across a window of up to 365 days.

### Weekly buckets since August

```bash
nylas deliverability send-events timeseries --granularity week --start 2026-08-01
```

### Daily buckets as JSON

```bash
nylas deliverability send-events timeseries --granularity day --json
```

## Troubleshooting

### invalid --start value on a metrics command

Metrics windows take UTC dates in YYYY-MM-DD form, both days included, and can span at most 365 days. Unix timestamps and look-backs are for the activity list commands only.

### A rate shows a dash instead of 0%

A dash means the rate has no denominator in the window (for example no sends), so there is no data. It is not a 0% rate.

## Related commands

[nylas deliverability send-alerts createCreate a send alert rule.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-create)

[nylas deliverability send-alerts deleteDelete a send alert rule.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-delete)

[nylas deliverability send-alerts listList send alert rules.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-list)

[nylas deliverability send-alerts showShow a send alert rule.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-show)

[nylas deliverability send-alerts updateChange a send alert rule; flags you leave out keep their value.](https://cli.nylas.com/docs/commands/deliverability-send-alerts-update)

[nylas deliverability send-events breakdownShow send counts and rates per sending domain, agent account, or recipient domain.](https://cli.nylas.com/docs/commands/deliverability-send-events-breakdown)

## Recommended guides

[Track Email Opens, Clicks, and RepliesSend tracked email and receive open, click, and reply events over webhooks from the terminal. Verify the signatures, and learn why email open rates overcount.](https://cli.nylas.com/guides/track-email-opens-replies-cli)

[SMTP Reply Codes ExplainedDecode SMTP reply codes: 2xx success, 4xx transient retry, 5xx permanent. Read bounce DSN enhanced codes and debug delivery from the terminal.](https://cli.nylas.com/guides/smtp-reply-codes-explained)

[Email Bounce Codes Reference (DSN)Decode bounce DSNs: RFC 3463 enhanced status codes (5.1.1, 5.2.2, 4.x.x), hard vs soft bounces, and finding them with nylas email search from:mailer-daemon.](https://cli.nylas.com/guides/email-bounce-codes-reference)

[Validate Email Addresses from the CLIValidate email addresses from the terminal with an RFC 5322 syntax check and a dig MX lookup, then gate nylas email send to cut hard bounces.](https://cli.nylas.com/guides/email-address-validation-cli)

[AI Agent Email Bounce Detection and RetryDeterministic bounce rules for AI agents: classify soft vs hard from DSN codes, retry 4.x.x with backoff, suppress 5.x.x, and escalate edge cases to humans.](https://cli.nylas.com/guides/ai-agent-email-bounce-retry)

[Soft Bounce vs Hard Bounce ExplainedSoft bounces (4xx) are transient and retried for up to 5 days; hard bounces (5xx) are permanent. Code ranges, suppression rules, and terminal detection with the CLI.](https://cli.nylas.com/guides/soft-bounce-vs-hard-bounce)

Run `nylas deliverability send-events timeseries --help` for full help output.