Skip to main content

​
usage

Show a billing usage summary for the organization, broken down into dedicated deployments, model APIs, and training. Pass --since (relative duration, e.g. 7d, 24h) for a sliding window ending now, or --start and --end together for an explicit ISO 8601 range. The two modes are mutually exclusive. The range cannot exceed 31 days and cannot start before 2026-01-01 UTC. Defaults to --since 7d.

​
Options

​
TEXT
End of the window. Accepts ISO 8601; values without a timezone are interpreted in the local timezone. Requires —start. Mutually exclusive with —since.
​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
TEXT
Relative window ending now (e.g. 24h, 7d). Used when neither —start nor —end is given. Maximum 31d. Mutually exclusive with —start/—end.
​
TEXT
Start of the window. Accepts ISO 8601 (e.g. ‘2026-05-01’, ‘2026-05-01T12:00:00Z’); values without a timezone are interpreted in the local timezone. Requires —end. Mutually exclusive with —since.
​
BOOL
Enable verbose logging

​
Examples

Show usage over the last 7 days (default)
Show usage over the last 30 days
Show usage over an explicit ISO 8601 range

​
Filter output with --jq

Print the total cost of model API usage

​
Output

Text mode (--output text): The resolved window on stderr, then a table on stdout with one row per category present (Dedicated, Model APIs, Training), plus an “All” total row when more than one category is present, with columns CATEGORY, MINUTES, TOTAL, CREDITS, SUBTOTAL. Costs are in USD; SUBTOTAL is the net cost after credits. Prints “No usage in the selected window.” to stderr when every category is absent. JSON mode (--output json): payload type managementapi.UsageSummary. The usage summary: optional dedicated_usage, model_apis_usage, and training_usage objects, each with total/credits_used/subtotal costs and a per-resource breakdown whose items each carry an optional daily series.