# pier billing

> Billing state and overage cap

URL: https://pier.run/docs/cli/reference/billing

```bash
pier billing <command>
```

Billing state and overage cap.

## Subcommands

### pier billing overview

```bash
pier billing overview
```

Show billing overview (plan, status, credits).

### pier billing charges

```bash
pier billing charges
```

Show recent charges.

### pier billing cap

```bash
pier billing cap <command>
```

Manage the workspace overage cap.

#### pier billing cap show

```bash
pier billing cap show
```

Show the current cap.

#### pier billing cap set

```bash
pier billing cap set [<amount>] [flags]
```

Set or update the cap.

| Argument   | Required | Description                                                  |
| ---------- | -------- | ------------------------------------------------------------ |
| `<amount>` | no       | Cap amount in USD (e.g. 50.00). Prompts when omitted on TTY. |

| Flag       | Value | Default        | Description          |
| ---------- | ----- | -------------- | -------------------- |
| `--action` |       | `hard_suspend` | What happens at 100% |

#### pier billing cap remove

```bash
pier billing cap remove [flags]
```

Remove the cap (= unlimited).

| Flag          | Value | Default | Description              |
| ------------- | ----- | ------- | ------------------------ |
| `-y`, `--yes` |       |         | Skip confirmation prompt |

[Global flags](/docs/cli/reference#global-flags) apply to every command.