costs
orc costs get retrieves daily credit cost buckets for the target Workspace. Use --group-by cost_type to split by cost type.
--start-time is a required inclusive RFC 3339 timestamp. --end-time is exclusive and must follow the start. The range cannot exceed 90 days. When omitted, the end defaults to the current time of each request; supply it explicitly to keep the range fixed while paging.
Usage
orc costs get --start-time 2026-09-01T00:00:00Z --end-time 2026-10-01T00:00:00ZRetrieve a fixed interval.
Aggregation and pagination
Omitting grouping aggregates matching records within each bucket. Group fields whose stored value is null are omitted from results. Pass returned --cursor values unchanged, retaining the range, filters, and grouping.
Subcommands
get
Costs support daily 1d buckets only. Group by cost_type.
orc costs get [options]Unique options
--start-time
Inclusive lower bound for usage records, as an RFC 3339 timestamp. Required. The range from start_time to end_time cannot exceed 90 days.
Type: string. Required.
orc costs get --start-time <value>--end-time
Exclusive upper bound for usage records. Must be after start_time. Defaults to the time of each request; set it explicitly to keep a fixed range across pages.
Type: string. Optional.
orc costs get --end-time <value>--bucket-width
Cost reports support daily buckets only. Defaults to 1d.; enum: 1d
Type: string. Optional.
orc costs get --bucket-width <value>--group-by
Split each time bucket by cost_type. Omit to aggregate all matching records in each bucket. Use repeated HTTP query parameters. A grouping field is omitted from a result when its stored value is null.; csv of: cost_type
Type: string. Optional.
orc costs get --group-by <value>Examples
Retrieve JSON by cost type.
orc costs get --start-time 2026-09-01T00:00:00Z --end-time 2026-10-01T00:00:00Z --group-by cost_type --jsonRetrieve JSON by cost type.
Permissions
Authenticate and select the target Workspace. Access to that Workspace is required.
Global Options
The following global options can be used with orc costs:
For details and examples, see global options.