---
title: "List Agents Route"
method: GET
path: "/api/v1/agents"
---

# List Agents Route

`GET /api/v1/agents`

## 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`
- Auth: none declared

## Query parameters

- `cursor` string, nullable
- `limit` integer
- `agent_kind` string, nullable
- `asset_id` string, nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- AgentsResponse
  - `items` AgentRow[], required
    - `id` string, required
    - `agent_kind` string, required
    - `agent_id` string, nullable, required
    - `composition_source` string, nullable, required
    - `composition_coverage` string, nullable, required
    - `latest_bom_id` string, nullable, required
    - `last_seen_at` string, nullable, required
    - `last_reevaluated_at` string, nullable, required
    - `asset_id` string, required
    - `asset_display_name` string, required
    - `component_count` integer, required
    - `component_type_counts` object
    - `finding_count` integer, required
    - `vulnerability_count` integer
    - `open_vulnerability_count` integer
    - `open_detection_count` integer
    - `records_in_pair` integer
    - `last_detect_run_at` string, nullable
  - `next_cursor` string, nullable
  - `total` integer, required
  - `summary` AgentsSummary
    - `total_agents` integer
    - `agents_by_kind` object
    - `last_seen_by_kind` object
    - `component_count_by_kind` object
    - `vulnerability_count_by_kind` object
    - `total_assets` 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)