v1

latestOpenAPI 3.0.32026-07-132681171.6 KB

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.

get/v1/manage/org/usage

Query parameters

startstring date-time required

Example:2025-01-01T00:00:00Z

Start date in RFC3339 format (e.g., 2025-01-01T00:00:00Z). Required. The date range cannot exceed 100 days from start to end.

endstring date-time

Example:2025-01-31T23:59:59Z

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.

resolution'hour' | 'day' | 'month'

Time resolution for aggregation

group_bystring[]

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, or extra.<field_name>. Can be specified multiple times.

Response

Successfully retrieved usage data

usageobject required

Map of period (string) to usage entry