> ## Documentation Index
> Fetch the complete documentation index at: https://www.landbase.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# account

> View, list, and switch the active Landbase account the CLI operates on

View the active account, list every account you can access, and switch between
them. The active account scopes account-level commands such as
[`onboarding`](/docs/reference/onboarding) and
[`contacts-import`](/docs/reference/contacts-import).

<Note>
  `account` is a **platform-mode** command (platform mode is the default). Run
  [`landbase-cli auth login`](/docs/reference/auth) first — `account list` and
  `account set` call the platform to read your memberships. See
  [platform mode vs. legacy mode](/docs/explanation/platform-vs-legacy).
</Note>

## account

Print the currently active account as JSON. This reads the stored config only —
no network call — so it is safe to run even with an expired session.

**Usage**

```bash theme={null}
landbase-cli account
```

Prints `{ accountId, source }`, where `source` is `"config"` when an account is
set or `"none"` when it isn't. See [output schemas](/docs/reference/output-schemas#account).

***

## account list

List every account the current user can access, marking which one is active.

**Usage**

```bash theme={null}
landbase-cli account list
```

Prints `{ accounts: [{ id, name, role, current }] }`. `current` reflects the
account the CLI would use right now. See
[output schemas](/docs/reference/output-schemas#account).

***

## account set

Set the active account and persist it to `~/.landbase/platform.json`. Run it
with no arguments — the CLI lists the accounts you can access and prompts you to
pick one. Your choice is saved, so you only do this once per machine.

**Usage**

```bash theme={null}
landbase-cli account set
```

```text theme={null}
Multiple accounts available — pick one:
  [1] Acme Corp (39)
  [2] Beta LLC (449)
  [3] Globex Inc (722)
  [4] Initech (962)
Enter 1-4:
```

To target a different account for a single command without changing the saved
one, use the `--account=<id>` flag instead (see below).

***

**Flags**

| Flag             | Default | Description                                                             |
| ---------------- | ------- | ----------------------------------------------------------------------- |
| `--account=<id>` | —       | Override the active account for a single command, without persisting it |
| `--verbose`      | —       | Print request/response details to stderr                                |

**Examples**

```bash theme={null}
# Print the active account (no network call)
landbase-cli account

# List accessible accounts
landbase-cli account list

# Switch account via the interactive picker
landbase-cli account set

# Use a different account for one command only (no persistence)
landbase-cli onboarding get --account=4821
```

## Related

* [How to select and onboard an account](/docs/how-to/select-and-onboard-account)
* [onboarding command reference](/docs/reference/onboarding)
* [contacts-import command reference](/docs/reference/contacts-import)
* [Output schemas](/docs/reference/output-schemas#account)
* [Platform mode vs. legacy mode](/docs/explanation/platform-vs-legacy)