Get usage for a date range
Return an organization’s usage for [start_date, end_date), in one bucket per calendar
month, clipped to the range and ending at the current month. The organization is identified
by the org_id path parameter alone; the x-hh-org-id header does not participate.
An event counts in the month that contains its start_time, which the client sets when it
logs the event, so usage for a past month can still grow. metrics_computed_count is the
number of metrics.* keys on those events. Results are always split by event_type; pass
group_by to also split them by workspace or by project. Every row is returned in one
response; there is no pagination. Quarter- and year-to-date totals are for the caller to
sum across ranges.
Authorizations
A fine-grained control-plane API key (values begin with hh_fgcp_). Project API keys used with the Data Plane API will not work here. Create one in the HoneyHive app under an organization's or workspace's Settings → API Keys.
Path Parameters
The unique identifier of the organization
Query Parameters
Inclusive start, YYYY-MM-DD (UTC), no later than today
Exclusive end, YYYY-MM-DD (UTC), 1 to 92 days after start_date
Split results by workspace, or by project (each project row also carries its workspace)
workspace_id, project_id