Getting started

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

terminal
orc costs get --start-time 2026-09-01T00:00:00Z --end-time 2026-10-01T00:00:00Z

Retrieve 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.

terminal
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.

terminal
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.

terminal
orc costs get --end-time <value>
--bucket-width

Cost reports support daily buckets only. Defaults to 1d.; enum: 1d

Type: string. Optional.

terminal
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.

terminal
orc costs get --group-by <value>

Examples

Retrieve JSON by cost type.

terminal
orc costs get --start-time 2026-09-01T00:00:00Z --end-time 2026-10-01T00:00:00Z --group-by cost_type --json

Retrieve 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.