v63

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

Projects

Logs

Organization

Project usage breakdown

Grouped metering usage breakdown for the authenticated project. Groups results by a single dimension or column key.

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

entity_typestring required

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

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.

Usage breakdown for the project.

entity_typestring required

unitstring required

total_quantitystring required

event_countinteger required