Skip to main content
GET
Get usage for a date range

Authorizations

Authorization
string
header
required

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

org_id
string
required

The unique identifier of the organization

Query Parameters

start_date
string<date>
required

Inclusive start, YYYY-MM-DD (UTC), no later than today

end_date
string<date>
required

Exclusive end, YYYY-MM-DD (UTC), 1 to 92 days after start_date

group_by
enum<string>

Split results by workspace, or by project (each project row also carries its workspace)

Available options:
workspace_id,
project_id

Response

Usage computed successfully

Org usage for a date range, in monthly buckets

success
enum<boolean>
required
Available options:
true
data
object
required