# Billing (/cli/billing)

Read billing status, credit usage, and storage usage.

These commands accept the [global options](/cli/commands#global-options).

## Show billing status, credits spent, and storage used \[#show-billing-status-credits-spent-and-storage-used]

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

```bash
sim billing status [options]
```

**Options**

| Option | Required | Description |
| - | - | - |
| `--all-workspaces` | No | Do not filter to the configured workspace (OAuth login or personal API key required for account-wide access). |

API request and response schemas: [getBillingStatus](/api-reference/billing/getBillingStatus).

## List credit usage events \[#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.

```bash
sim billing logs [options]
```

**Options**

| Option | Required | Description |
| - | - | - |
| `--source <value>` | No | Filter 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>` | No | Billing period. Defaults to "30d". Accepted values: `1d`, `7d`, `30d`, `all`, `custom`. |
| `--start-date <value>` | No | Custom period start (ISO 8601). |
| `--end-date <value>` | No | Custom period end (ISO 8601). |
| `--limit <n>` | No | Maximum items to return (0 for everything). Defaults to `100`. |
| `--cursor <value>` | No | Continue from nextCursor returned by a previous result. |
| `--all-workspaces` | No | Do not filter to the configured workspace (OAuth login or personal API key required for account-wide access). |

API request and response schemas: [listBillingLogs](/api-reference/billing/listBillingLogs).

## Related docs \[#related-docs]

- [Costs](/platform/costs)
- [Authentication](/cli/authentication)