Get Cost and Usage

Start of the range. Example: 2026-04-16

Must be on or after startDate. The span may not exceed 36 months. Example: 2026-08-16

Granularity. Values: day, week, month, quarter, year

Dimension(s) to group by (Two levels maximum). Example: ["service", "usagedate"]

Charge classification, not a cost metric. One or more of cost, credit, discount, refund, tax

Data source scope. By default, it is cloud+K8s. Specify whether to see only K8s or cloud costs. Example: costglobaltype: "cloud"

How the filter families combine - and (default) or or. Example: conjunction: {customtags: "or"}

GCP only. 'usagedate' (default) or 'invoicemonth'.

Measure emissions or water instead of cost. One of 'totalCarbonEmissions', 'usageCarbonEmissions', 'manufacturingCarbonEmissions', 'cloudUsageElectricityConsumption', 'waterElectricity', 'waterCooling', 'waterTotal'. The chosen figure replaces total_cost.

Keep the quantitytype filter applied to the usage side, for rate-per-unit queries.

For GCP only. Read the hourly table and bucket in PST rather than UTC.

Return amortized cost.

Return net unblended cost.

Return net unblended cost.

Return distributed (shared-cost-allocated) cost.

Return public (list) cost.

Distribute the node-level unused cost among the pods. Only meaningful with a Kubernetes groupBy

Pagination token, use the nextToken from previous response