---
title: "Observed AI system inventory (Exhibit A)"
method: GET
path: "/api/v1/usinsurance/inventory"
tags: ["US Insurance Compliance"]
---

# Observed AI system inventory (Exhibit A)

`GET /api/v1/usinsurance/inventory`

## Request

- Base URL: `https://orchestrator.getaxonflow.com`
- URL: `https://orchestrator.getaxonflow.com/api/v1/usinsurance/inventory`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/docs/api/v1/usinsurance/inventory/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the AI system surfaces OBSERVED in governed traffic during the
reporting window, with invocation counts and the governance verdicts
recorded against them. This is the spine of NAIC Supplement Exhibit A.

The response carries a `disclosure` string stating what the list is
not: AxonFlow does not discover AI systems outside the gateway, so this
is not a network-wide AI census, and it does not designate any system
as high risk. `unattributed_invocations` reports governed activity that
recorded no provider or model, so the item counts and the decision
volumes can be reconciled.

**Enterprise Feature**.

## Query parameters

- `period_start` string
- `period_end` string

## Headers

- `X-Org-ID` string
- `X-Tenant-ID` string

## Response `200`

Observed AI system inventory (Exhibit A)

- USInsuranceInventoryResponse
  - `items` USInsuranceInventoryItem[]
    - `system` string: Rendered identity, "provider / model".
    - `provider` string
    - `model` string
    - `request_types` string[]
    - `invocations` integer
    - `decision_counts` object: Counts keyed by the platform's own policy_decision vocabulary.
    - `first_seen` string, date-time
    - `last_seen` string, date-time
  - `total` integer
  - `unattributed_invocations` integer: Governed activity that recorded no provider and no model, so it could not be attributed to a model surface. Reported rather than dropped so the item counts and the decision volumes reconcile.
  - `period_start` string, date-time
  - `period_end` string, date-time
  - `completeness` USInsuranceCompleteness: The per-response completeness signal. It is ALWAYS present, populated or not, so a client never has to infer the good case from an absent field. `unavailable` means the backing surface is not present on this deployment, which is NOT the same as an empty result.
    - `complete` boolean, required: True when the read succeeded and returned everything it matched.
    - `truncated` boolean, required: True when the row cap was reached, so the items are a subset.
    - `unavailable` boolean, required: True when the backing surface is absent on this deployment.
    - `note` string: One sentence explaining a non-complete answer. Omitted when complete.
  - `disclosure` string: States what this list is not. AxonFlow does not discover AI systems outside the gateway and does not designate any system as high risk.

## Other responses

- `400`: Missing organization scope (`SCOPE_REQUIRED`) or an invalid window (`INVALID_PERIOD`)
- `405`: The US insurance read routes are GET-only
- `503`: The module is not available on this deployment (`USINSURANCE_NOT_AVAILABLE`)

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/revisions/f408ef3ec9dd?raw)