---
title: "Get object by ID"
method: GET
path: "/objects/{object-id}"
tags: ["Objects"]
---

# Get object by ID

`GET /objects/{object-id}`

Returns detailed information about a specific object

## Path parameters

- `object-id` string, required

## Response `200`

Object information

- 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 - 0x00000800: CREATE_ISSUE - 0x00001000: DOWNLOAD - 0x00002000: UPLOAD - 0x00004000: MANAGE_FILES - 0x00008000: MAINTENANCE - 0x00010000: READ_AGENT - 0x00020000: READ_SNMP - 0x00040000: SCREENSHOT - 0x00080000: EDIT_MNT_JOURNAL - 0x00100000: CONFIGURE_AGENT - 0x00200000: EDIT_COMMENTS - 0x00400000: EDIT_RESP_USERS - 0x00800000: DELEGATED_READ - 0x01000000: MANAGE_POLICIES - 0x02000000: MANAGE_INCIDENTS
  - `creationTime` integer
  - `parents` integer[]
  - `children` integer[]
  - `dashboards` integer[]
  - `customAttributes` object
  - `urls` object[]
  - `responsibleUsers` integer[]
  - `objectClassName` string

## Other responses

- `401` — Access denied
- `404` — Object not found

---

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