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

# projects usage

> Show project usage

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

Display usage metrics for the linked project over a date range. Shows daily breakdowns of total queries, cache hits, and data transferred by region. 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, Region, Queries, Cache Hits, and Data. With `--json`, returns the full usage response from the API.