---
title: "pols usage"
description: "Show per-second usage (default: this month)"
---

<!-- Generated by scripts/reference.mjs from the pols CLI's --help. Do not edit; run `npm run reference:sync`. -->

Show per-second usage (default: this month)

## Usage

```text
pols usage [flags]
```

## Examples

```sh
pols usage
pols usage --from 2026-09-01T00:00:00Z --to 2026-09-15T00:00:00Z
```

## Flags

```text
    --from string   window start, RFC 3339
-h, --help          help for usage
    --to string     window end (exclusive), RFC 3339
```

The [global flags](/reference/cli/#global-flags) work with this command too.