---
title: "List Fleet Activity Route"
method: GET
path: "/api/v1/activity"
---

# List Fleet Activity Route

`GET /api/v1/activity`

## Request

- Base URL: `https://api.stacktrace.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stacktrace.ai/api/v1/activity`
- Auth: none declared

## Query parameters

- `agent_kind` string, nullable
- `agent_id` string, nullable
- `asset_id` string, nullable
- `category` string, nullable
- `window` '1d' | '3d' | '7d' | '30d' | 'all', nullable
- `cursor` string, nullable
- `limit` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- FleetActivityResponse: The fleet's grouped activity, one page at a time. Three totals that are deliberately not the same number: - `total` — components used across the *window*, unmoved by the selected category, because it sits in a KPI strip whose every other card is also at the window. It never counts the unresolved bucket (ADR-0027). - `rows_total` — the population the pages walk: every grouped row the table would show under the current filters, unresolved bucket included. - `total_invocations` — calls, not components.
  - `items` FleetActivityRow[]
    - `category` string, required
    - `component_identity` string, nullable
    - `component_name` string, nullable
    - `component_type` string, nullable
    - `invocations` integer, required
    - `denied` integer
    - `sessions` integer, required
    - `agents` integer, required
    - `last_invoked_at` string, nullable
    - `last_reported_at` string
    - `agent_id` string, nullable
    - `asset_display_name` string, nullable
    - `agent_kind` string, nullable
    - `agent_instance_id` string, nullable
  - `next_cursor` string, nullable
  - `total` integer
  - `rows_total` integer
  - `total_invocations` integer
  - `by_category` ActivityCategoryCount[]
    - `category` string, required
    - `invocations` integer, required
    - `components` integer, required
  - `coverage` RuntimeCoverage: Derived by summing activity, never transmitted (ADR-0027). `resolved` counts calls the correlator could place. A low rate means the detector could not *read* those sessions — not that they were clean.
    - `total` integer
    - `resolved` integer
  - `sessions` integer
  - `agents` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stacktrace/apis/stacktrace-fleet-api.md) - [All operations](https://skmtc.dev/stacktrace/apis/stacktrace-fleet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stacktrace/apis/stacktrace-fleet-api/revisions/0ee5484d1d0b?raw)