v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB

Organization

Logs

Org usage breakdown

Grouped metering usage breakdown for the authenticated organization. Groups results by a single dimension or column key. By default includes all projects; use filters.project_id to restrict.

post/api/v3.1/org/usage/{entity_type}

Path parameters

entity_typestring required

Metering entity type to break down (e.g. tool_calls, sessions).

Request body

fromnumber

Inclusive range start (Unix epoch milliseconds). Defaults to 30 days before to.

tonumber

Exclusive range end (Unix epoch milliseconds). Defaults to now.

group_bystring

Dimension or column to group results by. Defaults to tool_slug for tool_calls and user_id for sessions.

order_by'key' | 'total_quantity' | 'event_count'

Field to order groups by. Defaults to total_quantity.

order_direction'asc' | 'desc'

Sort direction. Defaults to desc.

limitinteger

Maximum number of groups to return. Defaults to 100, max 1000.

Response

Usage breakdown for the organization.

entity_typestring required

unitstring required

total_quantitystring required

event_countinteger required