modal billing
View workspace billing information.
Usage:
Options:
--help: Show this message and exit.
Commands:
report: Generate a billing report for the workspace.
modal billing report
Generate a billing report for the workspace.
The report range can be provided by setting --start / --end dates (--end defaults to ‘now’)
or by requesting a date range using --for (e.g., --for today, --for 'last month').
Note that, as with the Billing API, the start date is inclusive and the end date is exclusive.
Data will be reported for full intervals only. Using --for is a convenient way to define a
complete interval.
Examples:
modal billing report —start 2025-12-01 —end 2026-01-01
modal billing report —for “last month” —tag-names team,project
modal billing report —for today —resolution h
modal billing report —for yesterday -r h —tz local
modal billing report —for “last month” —csv > report.csv
modal billing report —start 2025-12-01 —json > report.json
Usage:
Options:
--start TEXT: Start date. Date (in UTC by default): ISO format (2025-01-01) or relative (yesterday, 3 days ago, etc.).--end TEXT: End date. Date (in UTC by default): ISO format (2025-01-01) or relative (yesterday, 3 days ago, etc.). Defaults to now.--for TEXT: Convenience range: today, yesterday, this week, last week, this month, last month.-r, --resolution TEXT: Time resolution: ‘d’ (daily) or ‘h’ (hourly). [default: d]--tz TEXT: Timezone for date interpretation: ‘local’, offset (5, -4, +05:30), or IANA name. Requires hourly resolution.-t, --tag-names TEXT: Comma-separated list of tag names to include.--json: Output as JSON.--csv: Output as CSV.--help: Show this message and exit.