- Summary: totals across one or more entity types in a time window.
- Breakdown: one entity type, grouped by a dimension (tool, user, session, etc.).
POST /api/v3.1/project/usage/*) also appear on the Projects reference page.
Authentication
The org endpoints accept a
project_id filter so you can slice by project without rotating keys.
Entity types
Summary
Totals across entity types for a time window.- Python
- TypeScript
- API
Summary parameters
Breakdown
One entity type, grouped by a dimension. Useful for answering “top N” questions.- Python
- TypeScript
- API
Breakdown group_by options
Breakdown parameters
Filters
Filters live in afilters object on the request body. Each filter value is an array of strings, even for a single value:
- Within a single field, values are OR-combined (
user_id: ["a", "b"]matches events for user a or b). - Across fields, filters are AND-combined.
project_id filter is only meaningful on the org-scoped endpoints. Project endpoints accept the field but ignore it (your key already pins the scope to a single project).
Time ranges
fromandtoare epoch milliseconds.fromdefaults to 30 days beforeto.todefaults to the current time.- Maximum range: 366 days. Longer ranges return a 400.
Recipes
Top 10 tools my org called last week
The Python SDK requiresCOMPOSIO_API_KEY to initialize as well as COMPOSIO_ORG_API_KEY for the organization-scoped request.
- Python
- TypeScript
- API
Tool call count per user for my project this month
- Python
- TypeScript
- API
Which toolkits is a specific user using?
- Python
- TypeScript
- API