Get Organization Usage
Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, model, or custom fields.
group_by fields: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, extra.<field_name>, api_key_label.<label_key>, and group_label.<label_key>.
Authorizations
API key for authentication
Query Parameters
Start date in RFC3339 format (e.g., 2025-01-01T00:00:00Z). Required. The date range cannot exceed 100 days from start to end.
"2025-01-01T00:00:00Z"
End date in RFC3339 format (e.g., 2025-01-31T23:59:59Z). Optional. Defaults to 24 hours from start if not specified. Must be after start date. The date range cannot exceed 100 days.
"2025-01-31T23:59:59Z"
Time resolution for aggregation
hour, day, month Fields to group by: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, extra.<field_name>, api_key_label.<label_key>, or group_label.<label_key>. Rows missing a requested label are grouped under "Unknown". Can be specified multiple times.
Response
Successfully retrieved usage data
Map of period (string) to usage entry