---
title: "axiom client list"
description: "List your tenant's Client Builder clients"
category: reference
surfaces: [cli]
related: [reference/cli/axiom-client]
last_reviewed: 2026-06-06
---

<!-- GENERATED by docs/scripts/gen-cli-reference — DO NOT EDIT.
     Source of truth: the cobra command definitions in cmd/axiom/cmd/.
     Regenerate from the repo root with: go run ./docs/scripts/gen-cli-reference -->

# axiom client list

List your tenant's Client Builder clients

List every Client Builder client owned by your tenant.

```text
axiom client list
axiom client list --json    # machine-readable output
```

--json always emits a JSON array, even when there are zero or exactly one
client — a script or agent parsing the output can rely on one shape
regardless of count.

Requires a prior "axiom login".

## Usage

```sh
axiom client list [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for list |
| `--json` |  | bool |  | Emit a JSON array of clients (always an array, never a bare object) |

## See also

- [axiom client](./axiom-client.md) — Create and manage Client Builder clients (typed SDKs)