---
title: fastly stats historical
summary: View historical stats for a Fastly service
url: https://www.fastly.com/documentation/reference/cli/stats/historical
---

View historical stats for a Fastly service

## Flags

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--service-id` | Service ID (falls back to FASTLY_SERVICE_ID, then fastly.toml) | No | - |
| `--service-name` | The name of the service | No | - |
| `--field` | Filter to a single stats field (e.g. bandwidth, requests) | No | - |
| `--from` | From time, accepted formats at https://fastly.dev/reference/api/metrics-stats/historical-stats | No | - |
| `--to` | To time | No | - |
| `--by` | Aggregation period (minute/hour/day) | No | - |
| `--region` | Filter by region ('stats regions' to list) | No | - |
| `--json` | Render output as JSON | No | - |

## Global options

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--help` | Show context-sensitive help. | No | - |
| `--accept-defaults` | Accept default options for all interactive prompts apart from Yes/No confirmations | No | - |
| `--auto-yes` | Answer yes automatically to all Yes/No confirmations. This may suppress security warnings | No | - |
| `--debug-mode` | Print API request and response details (NOTE: can disrupt the normal CLI flow output formatting) | No | - |
| `--non-interactive` | Do not prompt for user input - suitable for CI processes. Equivalent to --accept-defaults and --auto-yes | No | - |
| `--quiet` | Silence all output except direct command output. This won't prevent interactive prompts (see: --accept-defaults, --auto-yes, --non-interactive) | No | - |
| `--token` | Fastly API token, or name of a stored auth token (use 'default' for the default token). Falls back to FASTLY_API_TOKEN env var | No | - |
| `--verbose` | Verbose logging | No | - |