---
title: "Read the latest allowlisted host inventory"
method: GET
path: "/platform/servers/{agent_id}/inventory"
tags: ["Platform"]
---

# Read the latest allowlisted host inventory

`GET /platform/servers/{agent_id}/inventory`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/servers/{agent_id}/inventory`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Requires host-inventory-v1 and agent 0.6.28 or newer. Reads the last report and requests a fresh observation at most once per 15 minutes; automatic collection is every six hours. Explicit offline, partial, stale and unsupported states. No host changes, private files, package repository refresh or submission to an AI provider. Only the latest report is retained per server. Requires read scope and server ownership.

## Path parameters

- `agent_id` string, required

## Response `200`

Latest facts, per-fact source and validity, server-resolved provider

- object
  - `success` boolean
  - `data` object

## Other responses

- `404`: Server not found on this account
- `503`: Inventory storage unavailable

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)