---
title: "Query AI operator observations"
method: GET
path: "/v1/ai/observations"
tags: ["AI Operators"]
---

# Query AI operator observations

`GET /v1/ai/observations`

Retrieve observations recorded by AI operator instances, most recent first. Requires the "view event log" system access right. Observations related to objects the caller has no read access to are excluded; server-level observations are always included.

## Query parameters

- `instance` integer
- `object` integer
- `state` 'new' | 'acknowledged' | 'dismissed'
- `since` string
- `limit` integer

## Response `200`

List of observations

- AiObservation[]
  - `id` integer — Unique observation identifier
  - `timestamp` string, date-time — Time the observation was recorded
  - `instanceId` integer — ID of the AI operator instance that recorded the observation
  - `severity` integer — Severity (0=normal, 1=warning, 2=minor, 3=major, 4=critical)
  - `title` string, nullable — Short observation title
  - `body` string, nullable — Detailed observation text
  - `objectId` integer — ID of the related object (0 if not related to a specific object)
  - `references` string[], nullable — References supporting the observation (event IDs, alarm IDs, DCI names, etc.)
  - `state` 'new' | 'acknowledged' | 'dismissed' — Observation triage state

## Other responses

- `400` — Invalid query parameters
- `403` — Insufficient access rights
- `404` — Object given in "object" parameter not found
- `500` — Database failure

## Changes

- **2026-09-17** `a203de7e5d7d` — 1 info
  - removed the non-success response with the status `503`
- **2026-09-17** `a81265c49fa9` — 1 info
  - added the non-success response with the status `503`
- **2026-09-08** `4fd66f32833f` — 1 info
  - added the non-success response with the status `404`
- **2026-07-11** `38f213f6e6b4` — 1 info
  - endpoint added
- **2026-05-08** `c6aaf3632e48` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/ai/observations/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/8dab9171ee5d?raw)