---
title: pulumi insights account list | CLI commands
url: /docs/iac/cli/commands/pulumi_insights_account_list/
---

[EXPERIMENTAL] List Insights accounts available to the authenticated user

## Synopsis

[EXPERIMENTAL] List Pulumi Insights accounts within an organization.

The organization defaults to the current default org and can be overridden
with --org. --parent restricts results to child accounts of the named parent
(e.g. an AWS Organizations management account). --role-id restricts results to
accounts accessible by a particular role.

By default the command returns a single page of results. --count N returns at
most N results. --all (equivalent to --count 0) returns every matching
account. --count and --all are mutually exclusive.

```
pulumi insights account list [flags]
```

## Examples

```
  # List the first page of Insights accounts in the default organization.
  pulumi insights account list

  # Return every matching account.
  pulumi insights account list --all

  # Return at most 250 accounts.
  pulumi insights account list --count 250

  # Filter to child accounts of an AWS Organizations management account.
  pulumi insights account list --parent aws-management

  # Emit JSON for scripting.
  pulumi insights account list --output json
```

## Options

```
      --all              Return every matching account
      --count int        Return at most this many accounts (--count 0 is equivalent to --all)
  -h, --help             help for list
      --org string       Organization to list accounts for (defaults to the current default org)
      --output string    Output format. Supported values are: default and json (default "default")
      --parent string    Filter to child accounts of the named parent account
      --role-id string   Filter to accounts accessible by the named role
```

## 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 insights account](/docs/iac/cli/commands/pulumi_insights_account/)	 - [EXPERIMENTAL] Manage Pulumi Insights accounts