# Org usage summary

**Documentation:** /reference/api-reference/organization/getOrgUsageSummary

Aggregated metering usage for the authenticated organization across all projects. Requires ClickHouse logging (`USE_CLICKHOUSE_FOR_LOGS`). Values are summed from raw metering events grouped by `entity_type`.

---

## GET `/api/v3/org/usage/summary`

**Endpoint:** `https://backend.composio.dev/api/v3/org/usage/summary`

**Summary:** Org usage summary

Aggregated metering usage for the authenticated organization across all projects. Requires ClickHouse logging (`USE_CLICKHOUSE_FOR_LOGS`). Values are summed from raw metering events grouped by `entity_type`.

### Query Parameters

- `start_time` (string): Inclusive range start (ISO 8601). Defaults to 30 days before end_time.
- `end_time` (string): Exclusive range end (ISO 8601). Defaults to now.
- `entity_types` (array,null): Filter to these metering entity types (comma-separated or repeated query keys). Omit for all types.

### Responses

#### 200 - Usage aggregates for the organization.

**Response Schema:**

- `rows` (array<object>) *(required)*
  - Array items:
    - `entity_type` (string) *(required)*
    - `unit` (string) *(required)*
    - `total_quantity` (string) *(required)*
    - `event_count` (integer) *(required)*

**Example Response:**

```json
{
  "rows": [
    {
      "entity_type": "string",
      "unit": "string",
      "total_quantity": "string",
      "event_count": 0
    }
  ]
}
```

#### 400 - Invalid time range, entity_types, or query parameters.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Authentication required.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 403 - Forbidden.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 500 - Failed to load usage from analytics store or feature configuration.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X GET "https://backend.composio.dev/api/v3/org/usage/summary" \
  -H "x-api-key: YOUR_API_KEY"
```