---
title: "List Agent Activity Route"
method: GET
path: "/api/v1/agents/{agent_id}/activity"
---

# List Agent Activity Route

`GET /api/v1/agents/{agent_id}/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/agents/{agent_id}/activity`
- Auth: none declared

## Path parameters

- `agent_id` string, required

## Query parameters

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

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- AgentActivityResponse: One agent's grouped activity, one page at a time. Two counts, because they answer different questions and diverge whenever a call went unattributed: `total` is components used, the figure the console shows as a KPI, and it excludes the unresolved bucket because that bucket is not a component (ADR-0027). `rows_total` is the population these pages walk, and it includes that bucket, because the table has a row for it.
  - `items` AgentActivityRow[]
    - `category` string, required
    - `component_identity` string, nullable
    - `component_name` string, nullable
    - `component_type` string, nullable
    - `invocations` integer, required
    - `denied` integer
    - `sessions` integer, required
    - `last_invoked_at` string, nullable
    - `last_reported_at` string, required
  - `next_cursor` string, nullable
  - `total` integer
  - `rows_total` integer
  - `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

## 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)