--- search: tags: - workspaces - GET seo: description: >- Usage summed per bucket of the span and per value of… Reference for the GET /v1/workspaces/{workspace_id}/usage-report endpoint in the Subako Public API API. sidebar: label: Get the workspace's usage report badge: GET title: Get the workspace's usage report type: openapi-operation --- Usage summed per bucket of the span and per value of each `group_by` dimension, split by kind and by how it was priced: `rated` usage a charge landed with, `byok` calls through the workspace's own model provider, and `unrated` usage no rate priced. Usage counts toward the instant it is accounted at, which is when it occurred unless it was recorded after that instant was final. A row whose `ending_at` is at or before `finalized_before` never changes again, so re-reading only the rows after it, and taking the difference from what was read before, accounts every row exactly once.