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

# Project usage summary

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

Aggregated metering usage for the authenticated project only. 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.

## Response `200`

Usage aggregates for the project.

- object
  - `entities` object, required

## Other responses

- `400` — Invalid time range, entity_types, or query parameters.
- `401` — Authentication required.
- `403` — Forbidden.
- `404` — Project not found.
- `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/versions/4239836857f8/schema)