Usage

Retrieve finalized row usage (unique and total rows) grouped by date, workspace, and datastream, scoped to the API key's workspace hierarchy. Supports daily and monthly granularity. Only finalized data (through yesterday) is returned; the current day is excluded until daily aggregation completes. If date_from is omitted it defaults to the first of the anchor month (date_to's month when date_to is given, otherwise the current month, or the previous month on the 1st when the current month has no finalized days yet), so the window is always bounded; set date_from explicitly to query a wider range. Use workspace_id / datastream_id to narrow within the accessible hierarchy: workspace_id matches the given workspace(s) exactly and does NOT roll up descendants (the workspaces the API key can reach are always the outer bound: its own workspace and descendants, without those scheduled for deletion). Both workspace_id and datastream_id accept multiple values; repeat the parameter to filter on a set (e.g. ?workspace_id=<uuid>&workspace_id=<uuid>).

• granularitystring

  One of daily monthly · Default "daily"

• date_fromstring · date
• date_tostring · date
• workspace_idarray of string · uuid
• datastream_idarray of string · uuid
• pageinteger

  Default 1 · Min 1

• page_sizeinteger

  Default 50 · Min 1

200OKapplication/json