Billing

Read billing status, credit usage, and storage usage.

These commands accept the global options.

Show billing status, credits spent, and storage used

Credits and storage require an OAuth login or personal API key.

sim billing status [options]

Options

OptionRequiredDescription
--all-workspacesNoDo not filter to the configured workspace (OAuth login or personal API key required for account-wide access).

API request and response schemas: getBillingStatus.

List credit usage events

An OAuth login or personal API key reports only your events; a workspace API key reports every member's in aggregate, unattributed.

sim billing logs [options]

Options

OptionRequiredDescription
--source <value>NoFilter by usage source; sim-chat combines Sim agent and workspace Chat usage. Accepted values: workflow, wand, sim-chat, mcp_copilot, mothership_block, knowledge-base, voice-input, enrichment, voice-output, api-tool.
--period <value>NoBilling period. Defaults to "30d". Accepted values: 1d, 7d, 30d, all, custom.
--start-date <value>NoCustom period start (ISO 8601).
--end-date <value>NoCustom period end (ISO 8601).
--limit <n>NoMaximum items to return (0 for everything). Defaults to 100.
--cursor <value>NoContinue from nextCursor returned by a previous result.
--all-workspacesNoDo not filter to the configured workspace (OAuth login or personal API key required for account-wide access).

API request and response schemas: listBillingLogs.