Returns credits spent per workflow sheet in the requested window, ranked by credits. Defaults to the current calendar month (UTC).

One row is one SHEET, not one workflow. A workflow with three sheets produces three rows sharing a workflow_id; sum them for the workflow total. Names match the Sheet schema — sheet_id is the row, workflow_id is the workflow it belongs to — so either can be passed straight to the workflow endpoints. is_main_sheet marks the workflow's own main sheet, whose sheet_id equals its workflow_id.

Capped at the 100 highest-spending sheets, and not paginated. Narrow the window to see further down.

Sources are reported separately by List Source Usage, not here.

Deleted workflows still appear with deleted: true — their runs really did spend credits in the window, so dropping them would under-report the total.

What the key can see. A key holding org:read (admin only) reports the whole organization. Any other key reports only the usage of the member who created it, so a sheet a colleague ran is absent.

Requires the billing:read scope, which every role holds.