---
title: "auth status"
description: "Show current authentication status"
canonical: "https://pgbeam.com/docs/cli/auth/status"
last-updated: "2026-10-29T19:01:20.000Z"
---

# auth status

> Show current authentication status

URL: https://pgbeam.com/docs/cli/auth/status

{/* Auto-generated from CLI commands. Do not edit. Run `pnpm generate:cli-docs` to regenerate. */}

Display the credential the CLI would use (masked), where it came from (profile, flag, or environment), the authentication method, the organization and where it came from, and email. When the API is reachable, the credential is verified live with a cheap authenticated call; offline, the stored details are shown unverified. If not authenticated, prints a warning with instructions to log in. Also available as the `pgbeam whoami` alias.

## Usage

```bash
pgbeam auth status
```

> **Global options**
>
> All [global options](/docs/cli/global-options) (`--token`, `--profile`,
> `--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
> also available on this command.

## Examples

```bash
# Check who you are authenticated as
pgbeam auth status

# Same thing, using the alias
pgbeam whoami

# Get auth status as JSON for scripting
pgbeam auth status --json
```

## Output

Displays profile name (or credential source), method, masked key, email, organization, and live verification result. With `--json`, returns an object with `authenticated`, `verified`, `profile`, `source`, `method`, `key`, `orgId`, `orgName`, `orgSource` (`flag`, `profile-flag`, `env-profile`, `profile`, or `none`), and `email` fields. Exits non-zero when the credential is missing or rejected by the API.