---
title: pulumi org usage get | CLI commands
url: /docs/iac/cli/commands/pulumi_org_usage_get/
---

[EXPERIMENTAL] Fetch the resources-under-management summary for an organization

## Synopsis

[EXPERIMENTAL] Fetch the resources-under-management summary for an organization.

Returns the Resources Under Management (RUM) and Resource Hours Under
Management (RHUM) totals for the organization, bucketed by the requested
granularity. Default output is a human-readable table; pass --output=json
for the full response as a JSON envelope.

Wraps the `GetUsageSummaryResourceHours` Pulumi Cloud REST endpoint.

```
pulumi org usage get [flags]
```

## Examples

```
  # Summary for the default org, server-chosen granularity and window.
  pulumi org usage get

  # Daily summary for the last 30 days.
  pulumi org usage get --granularity daily --lookback-days 30

  # Hourly summary ending at a specific time (Unix seconds).
  pulumi org usage get --granularity hourly --lookback-start 1700000000

  # JSON output for scripting.
  pulumi org usage get --output json
```

## Options

```
      --granularity string   Time granularity for aggregation. One of: hourly, daily, monthly (default "daily")
  -h, --help                 help for get
      --lookback-days int    Number of days to look back from --lookback-start (or the current time) (default 30)
      --lookback-start int   Unix timestamp (seconds) marking the end of the lookback window
      --org string           Organization to fetch usage for (defaults to the current default org)
      --output string        Output format. Supported values are: default and json (default "default")
```

## Options inherited from parent commands

```
      --color string                 Colorize output. Choices are: always, never, raw, auto (default "auto")
  -C, --cwd string                   Run pulumi as if it had been started in another directory
      --disable-integrity-checking   Disable integrity checking of checkpoint files
  -e, --emoji                        Enable emojis in the output
  -Q, --fully-qualify-stack-names    Show fully-qualified stack names
      --logflow                      Flow log settings to child processes (like plugins)
      --logtostderr                  Log to stderr instead of to files
      --memprofilerate int           Enable more precise (and expensive) memory allocation profiles by setting runtime.MemProfileRate
      --non-interactive              Disable interactive mode for all commands
      --otel-traces string           Export OpenTelemetry traces to the specified endpoint. Use file:// for local JSON files, grpc:// for remote collectors
      --profiling string             Emit CPU and memory profiles and an execution trace to '[filename].[pid].{cpu,mem,trace}', respectively
      --tracing file:                Emit tracing to the specified endpoint. Use the file: scheme to write tracing data to a local file
  -v, --verbose int                  Enable verbose logging (e.g., v=3); anything >3 is very verbose
```

## SEE ALSO

* [pulumi org usage](/docs/iac/cli/commands/pulumi_org_usage/)	 - [EXPERIMENTAL] Inspect organization resource usage


