---
title: "List alarms"
method: GET
path: "/alarms"
tags: ["Alarms"]
---

# List alarms

`GET /alarms`

Returns alarms with optional filtering.
Supports filtering by object, state, time range, key, and message.

## Query parameters

- `objectId` integer
- `objectGuid` string, uuid
- `includeChildObjects` boolean
- `state` string
- `createdBefore` integer
- `createdAfter` integer
- `updatedBefore` integer
- `updatedAfter` integer
- `key` string
- `keyRegex` string
- `message` string
- `resolveReferences` boolean

## Response `200`

List of alarms

- object
  - `alarms` Alarm[]
    - `id` integer
    - `parentId` integer
    - `creationTime` integer
    - `lastChangeTime` integer
    - `sourceObjectId` integer
    - `sourceEventCode` integer
    - `sourceEventId` integer
    - `dciId` integer
    - `currentSeverity` integer
    - `originalSeverity` integer
    - `repeatCount` integer
    - `state` integer — 0: OUTSTANDING, 1: ACKNOWLEDGED, 2: RESOLVED, 3: TERMINATED
    - `message` string
    - `key` string
    - `helpDeskState` integer
    - `helpDeskRef` string
    - `acknowledgedByUser` integer
    - `resolvedByUser` integer
    - `terminatedByUser` integer
    - `ackTimeout` integer
    - `categories` object[]
      - `id` integer
      - `name` string
    - `sourceObject` AbstractObject
      - `objectId` integer
      - `guid` string, uuid
      - `objectName` string
      - `alias` string
      - `nameOnMap` string
      - `objectClass` integer
      - `categoryId` integer
      - `flags` integer
      - `status` 'NORMAL' | 'WARNING' | 'MINOR' | 'MAJOR' | 'CRITICAL' | 'UNKNOWN' | 'UNMANAGED' | 'DISABLED' | 'TESTING'
      - `isDeleted` boolean
      - `inMaintenanceMode` boolean
      - `maintenanceInitiatorId` integer
      - `comments` string
      - `commentsSource` string
      - `geolocation` Geolocation
        - `type` integer — 0: UNSET, 1: MANUAL, 2: GPS, 3: NETWORK
        - `latitude` number, double
        - `longitude` number, double
        - `accuracy` integer — Accuracy in meters
        - `timestamp` integer — Unix timestamp
      - `postalAddress` PostalAddress
        - `country` string
        - `region` string
        - `city` string
        - `district` string
        - `streetAddress` string
        - `postcode` string
      - `mapImage` string, uuid
      - `drillDownObjectId` integer
      - `trustedObjects` integer[]
      - `inheritAccessRights` boolean
      - `accessList` AccessListElement[]
        - `userId` integer
        - `accessRights` integer — Bit flags: - 0x00000001: READ - 0x00000002: MODIFY - 0x00000004: CREATE - 0x00000008: DELETE - 0x00000010: READ_ALARMS - 0x00000020: ACL - 0x00000040: UPDATE_ALARMS - 0x00000080: SEND_EVENTS - 0x00000100: CONTROL - 0x00000200: TERM_ALARMS - 0x00000400: PUSH_DATA - 0x00008000: MAINTENANCE
      - `creationTime` integer
      - `parents` integer[]
      - `children` integer[]
      - `dashboards` integer[]
      - `customAttributes` object
      - `urls` object[]
      - `responsibleUsers` integer[]
      - `objectClassName` string
    - `sourceEventName` string
    - `acknowledgedByUserName` string
    - `resolvedByUserName` string
    - `terminatedByUserName` string
    - `dci` DciValue
      - `id` integer
      - `nodeId` integer
      - `name` string
      - `description` string
      - `value` string
      - `timestamp` integer
      - `status` integer
      - `dataType` integer
      - `errorCount` integer
      - `activeThresholdSeverity` integer
    - `zoneUIN` integer
    - `zoneName` string

## Other responses

- `401` — Access denied

## Changes

- **2026-01-30** `32f48ec94aec` — 1 info
  - endpoint added
- **2023-02-23** `9c09a2aad349` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/netxms/apis/netxms-rest-api/changes/alarms/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-rest-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-rest-api/revisions/32f48ec94aec/schema)