Skip to main content

shift-cli billing

Billing — cost tracking and financial record management.

Usage​

shift-cli billing <subcommand> [arguments] [flags]

Description​

The Billing CLI provides access to the platform's billing service for managing cost items, categories, and financial reports. It interfaces with the Billing API mounted at /api/v1/billing/* on the gateway.

Subcommands​

Items​

# List billing items
shift-cli billing items list [--category <id>] [--since <date>] [--json]

# Get a specific item
shift-cli billing items get <id-or-name> [--json]

# Create a billing item
shift-cli billing items create \
  --amount 12.50 \
  --currency USD \
  --description "API usage - March" \
  --category infrastructure \
  --provider openai \
  [--date 2026-03-01] \
  [--recurring monthly] \
  [--json]

# Update an item
shift-cli billing items update <id> --amount 15.00 [--json]

# Delete an item
shift-cli billing items rm <id> [--json]

Categories​

# List categories
shift-cli billing categories list [--json]

# Create a category
shift-cli billing categories create --name infrastructure --json

# Delete a category
shift-cli billing categories rm <id-or-name> [--json]

Reports​

# Generate a summary report
shift-cli billing report [--since <date>] [--until <date>] [--group-by category] [--json]

Sync​

# Sync billing data from external providers
shift-cli billing sync [--provider <name>] [--json]

Examples​

# List all items for the current month
shift-cli billing items list --since 2026-03-01 --json

# Create a recurring infrastructure cost
shift-cli billing items create \
  --amount 49.99 \
  --currency USD \
  --description "GKE cluster" \
  --category infrastructure \
  --provider gcp \
  --recurring monthly \
  --json

# Generate a monthly report grouped by category
shift-cli billing report --since 2026-03-01 --until 2026-03-31 --group-by category --json