---
title: "List Incidents"
method: GET
path: "/v1/incidents"
tags: ["Incidents"]
---

# List Incidents

`GET /v1/incidents`

Retrieve incident summaries, newest first. Reads from the database, so closed incidents are included as well. Only incidents whose source object is readable by the caller are returned.

## Query parameters

- `objectId` integer
- `state` string
- `from` string
- `to` string
- `limit` integer

## Response `200`

Successful retrieval of incidents.

- IncidentSummary[]
  - `id` integer — Unique incident identifier.
  - `state` integer — Incident state: 0 open, 1 in progress, 2 blocked, 3 resolved, 4 closed.
  - `stateName` string — Human-readable incident state name.
  - `title` string — Incident title (up to 255 characters).
  - `sourceObjectId` integer — ID of object the incident was created on.
  - `sourceObjectName` string — Name of the source object.
  - `assignedUserId` integer — ID of user the incident is assigned to, or 0 when unassigned.
  - `assignedUserName` string — Login name of assigned user. Unassigned incidents must be detected by testing assignedUserId for 0, not by matching on this name - user ID 0 resolves to the built-in "system" account.
  - `alarmCount` integer — Number of alarms linked to the incident.
  - `creationTime` string, date-time — Incident creation time.
  - `lastChangeTime` string, date-time — Time of last incident change.

## Other responses

- `400` — Invalid filter parameters
- `401` — Unauthorized

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)