---
# Generated by kapten-docs from the CLI's command tree. DO NOT EDIT.
title: "kapten usage"
description: "Show environment usage for billing."
sidebar:
  label: "usage"
---

Every command takes the [global flags](/cli/reference#global-flags).

## kapten usage environments

How long each environment of the token's organization was active in the period [since, until), from its creation to its deletion. Usage is counted in hourly UTC windows: both bounds are truncated to the hour, and a period spans at most 93 days. Only hours before `closed_through` are counted, and an hour closes about five minutes after it ends. Environments that were not active in the period are left out. Requires organization_update on the organization. The billable minutes are the ones the subscription is billed for.

```bash
kapten usage environments <since> <until> [flags]
```

| Argument | Description |
| --- | --- |
| `since` | Start of the period, truncated to the hour. |
| `until` | End of the period (exclusive), truncated to the hour. |

Example:

```bash
kapten usage environments <since> <until>
```
