---
title: "List Inventory Route"
method: GET
path: "/api/v1/inventory"
---

# List Inventory Route

`GET /api/v1/inventory`

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

## Query parameters

- `cursor` string, nullable
- `limit` integer
- `component_type` string, nullable
- `agent_kind` string, nullable
- `agent_id` string, nullable
- `sort` string
- `direction` string
- `include_not_installed` boolean

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- InventoryResponse
  - `items` InventoryComponentRow[], required
    - `key` string, required
    - `agent_kinds` string[], required
    - `identity` string, nullable, required
    - `bom_id` string, nullable, required
    - `component_bom_ref` string, nullable, required
    - `purl` string, nullable, required
    - `component_type` string, required
    - `name` string, required
    - `version` string, nullable, required
    - `asset_count` integer, required
    - `agent_count` integer, required
    - `component_agent_count` integer, required
    - `component_type_filters` string[]
    - `occurrence_count` integer, required
    - `inactive_occurrence_count` integer
    - `not_installed_occurrence_count` integer
    - `inactive_via` string[]
    - `vulnerability_counts` SeverityCounts, required
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `posture_counts` SeverityCounts, required
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `observation_counts` SeverityCounts, required
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `policy_target` InventoryPolicyTarget: An MCP server's `command` or `url`, or a plugin's `name@marketplace`. Exactly one is set; the others are sent as null.
      - `command` string[], nullable
      - `url` string, nullable
      - `plugin` string, nullable
  - `next_cursor` string, nullable
  - `total` integer, required
  - `summary` EvidenceSummary, required
    - `component_count` integer
    - `impacted_component_count` integer
    - `vulnerability_count` integer
    - `posture_count` integer
    - `observation_count` integer
    - `vulnerability_counts` SeverityCounts
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `posture_counts` SeverityCounts
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `observation_counts` SeverityCounts
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `component_type_counts` object
  - `available_agent_kinds` string[]
  - `hidden_not_installed_count` 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)