---
title: "axiom client status"
description: "Show a client version's per-language build status"
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 status

Show a client version's per-language build status

Show the build status of every language row for one version of a client.

```text
axiom client status c1 --version 2
axiom client status c1 --version 2 --watch     # poll until every language finishes
axiom client status c1 --version 2 --json
```

--watch polls until every language row for the version reaches a terminal
status (succeeded or failed), then exits. It exits non-zero if any language
ended failed — --watch never reports success on a failed build, and it never
polls forever: a canceled/expired context stops it too.

Requires a prior "axiom login".

## Usage

```sh
axiom client status <client-id> [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for status |
| `--json` |  | bool |  | Emit a JSON array of the version's build rows |
| `--version` |  | int | `0` | Version to show status for (required) |
| `--watch` |  | bool |  | Poll until every language in the version reaches succeeded or failed |

## See also

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