# CLI reference

## `gotactl accounts`

List and inspect accounts

## `gotactl accounts get`

Get an account by ID

## `gotactl accounts list`

List accounts

## `gotactl api`

Send a raw API request resolved through the API catalog

## `gotactl api-keys`

List, create, roll, and revoke API keys for the active context

## `gotactl api-keys create`

Create an API key in the active context (requires OAuth)

## `gotactl api-keys list`

List API keys in the active context

## `gotactl api-keys revoke`

Revoke an API key in the active context (requires OAuth)

## `gotactl api-keys roll`

Roll an API key in the active context (requires OAuth)

## `gotactl auth`

Authenticate and manage profiles

## `gotactl auth login`

Sign in via device grant, browser PKCE (--web), or API key (--with-api-key)

## `gotactl auth logout`

Revoke the active session and remove local credentials

## `gotactl auth status`

Show current authentication status, profile, and issuer

## `gotactl auth switch`

Switch the active profile in config.toml

## `gotactl contexts`

List and switch account contexts

## `gotactl contexts list`

List available contexts for the signed-in account

## `gotactl contexts use`

Switch the active OAuth session to another context

## `gotactl customers`

Manage customers

## `gotactl customers get`

Get a customer by ID

## `gotactl customers list`

List customers

## `gotactl docs`

Export the CLI command tree and metadata (use --json)

## `gotactl events`

Trigger domain events in a sandbox

## `gotactl events trigger`

Trigger a real domain event in the active sandbox

## `gotactl invoices`

List and inspect invoices

## `gotactl invoices get`

Get an invoice by ID

## `gotactl invoices list`

List invoices

## `gotactl openapi`

Print the OpenAPI document discovered from the API catalog

## `gotactl organizations`

List the organizations on the platform

## `gotactl organizations get`

Get an organization by ID

## `gotactl organizations list`

List the organizations on the platform

## `gotactl payments`

List and inspect payments

## `gotactl payments get`

Get a payment by ID

## `gotactl payments list`

List payments

## `gotactl plans`

List the subscription plans

## `gotactl plans get`

Get a plan by ID or code

## `gotactl plans list`

List the subscription plans

## `gotactl readings`

List and submit meter readings

## `gotactl readings list`

List meter readings

## `gotactl readings submit`

Submit a meter reading

## `gotactl sandbox`

Manage sandbox state and simulated payments

## `gotactl sandbox advance`

Advance pending simulated payments or generate sandbox readings

## `gotactl subscriptions`

List the utilities' subscriptions

## `gotactl subscriptions get`

Get a subscription by ID

## `gotactl subscriptions list`

List the utilities' subscriptions

## `gotactl utilities`

List the utilities on the platform

## `gotactl utilities get`

Get a utility by tenant ID or slug

## `gotactl utilities list`

List the utilities on the platform

## `gotactl version`

Print version, commit, build date, and configured API URL

## `gotactl webhooks`

Listen to and forward webhook events

## `gotactl webhooks listen`

Forward domain events from the API to a local HTTP endpoint

## `gotactl whoami`

Show the current identity, active context, or API key details

