---
title: "Aggregate Usage Events"
method: GET
path: "/api/v1/dashboard/usage"
tags: ["dashboard"]
---

# Aggregate Usage Events

`GET /api/v1/dashboard/usage`

List usage events sorted chronologically by timestamp. Events can be filtered by workspace, user, or access token.

Filter combinations:
- Multiple filters (e.g. workspace_id & user_id) use AND logic
- Multiple values for same filter (e.g. workspace_id=123&workspace_id=456) use OR logic

Pagination:
- Use starting_after with event IDs for cursor-based navigation
- has_more indicates if more events exist beyond limit
- total_count (optional) shows total matching events up to 100,000

## Query parameters

- `workspace_ids` string[], required — Filter by workspace IDs. Must contain at least one ID.
- `start_time` string, date-time, required — Include events starting from this date (inclusive)
- `end_time` string, date-time, required — Include events until this date (exclusive)
- `user_ids` string[], nullable — Filter by user IDs

## Response `200`

Usage events listed successfully

- UsageEventsAggregateResponse
  - `data` AggregationResult[], required — Aggregated usage data
    - `workspaceId` string, required — Workspace ID
    - `userId` string, required — User ID
    - `date` string, required — Date in YYYY-MM-DD format
    - `count` integer, required — Count of events
    - `userEmail` string, email, required — User's email address

## Other responses

- `401` — Unauthorized
- `403` — Permission denied
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/askui/apis/askui-workspaces-api.md) · [All operations](https://skmtc.dev/askui/apis/askui-workspaces-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/askui/askui-workspaces-api/revisions/b796c74292ac/schema)