---
title: "auth status"
description: "Show current authentication status"
canonical: "https://pgbeam.com/docs/cli/auth/status"
last-updated: "2026-09-14T19:37:21.000Z"
---

# auth status

> Show current authentication status

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

Display the credential the CLI would use (masked), where it came from (profile, flag, or environment), the authentication method, organization, 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

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## 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`, and `email` fields. Exits non-zero when the credential is missing or rejected by the API.