---
title: "Org usage summary"
method: POST
path: "/api/v3.1/org/usage/summary"
tags: ["Organization", "Logs"]
---

# Org usage summary

`POST /api/v3.1/org/usage/summary`

Aggregated metering usage for the authenticated organization. By default includes all projects; use `filters.project_id` to restrict to one or more projects (must belong to the org). Values are summed from raw metering events grouped by `entity_type`.

## Request body

- object
  - `from` number — Inclusive range start (Unix epoch milliseconds). Defaults to 30 days before `to`.
  - `to` number — Exclusive range end (Unix epoch milliseconds). Defaults to now.
  - `entity_types` string[] — Filter to these metering entity types. Omit for all types.
  - `filters` object
    - `user_id` string[], nullable — Filter to events matching these external end-user IDs. OR logic within the array.
    - `session_id` string[], nullable — Filter to events matching these session IDs. OR logic within the array.
    - `project_id` string[], nullable — Restrict aggregates to one or more projects (must belong to the authenticated organization). OR logic within the array. Omit for org-wide totals.

## Response `200`

Usage aggregates for the organization.

- object
  - `entities` object, required

## Other responses

- `400` — Invalid time range, entity_types, or query parameters.
- `401` — Authentication required.
- `403` — Forbidden.
- `404` — Unknown project_id or project not in this organization.
- `500` — Failed to load usage from analytics store or feature configuration.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)