---
title: "orgs usage"
description: "Show organization usage"
canonical: "https://pgbeam.com/docs/cli/orgs/usage"
last-updated: "2026-09-14T19:37:21.000Z"
---

# orgs usage

> Show organization usage

URL: https://pgbeam.com/docs/cli/orgs/usage

Display aggregated usage metrics for the active organization over a date range. Shows daily breakdowns of total queries, cache hits, and data transferred across all projects. Defaults to the current calendar month if no date range is specified.

## Usage

## Options

Option

Description

Required

Default

`--start-date <value>`

Start of the date range in YYYY-MM-DD format. Defaults to the first day of the current month.

No

-

`--end-date <value>`

End of the date range in YYYY-MM-DD format. Defaults to today.

No

-

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Displays total queries and data transferred, followed by a day-by-day table with columns: Day, Queries, Cache Hits, and Data. With `--json`, returns the full usage response.