---
title: "Changes to Get objects with filters"
method: GET
path: "/objects"
---

# Changes to Get objects with filters

`GET /objects`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 16 revisions.

- **2026-01-30** `32f48ec94aec`: 2 breaking, 2 warning, 7 info
- **2023-02-28** `910d3ad08e09`: 2 info
- **2023-02-23** `9c09a2aad349`: 1 breaking, 5 warning, 5 info

## Changes

- **2026-01-30** `32f48ec94aec`: 2 breaking, 2 warning, 7 info
  - for the `query` request parameter `topLevelOnly`, default value `false` was added
  - for the `query` request parameter `parent`, the type changed from `string` to `integer`, and format from no format to `int64`
  - deleted the `query` request parameter `@custom_attribute_name`
  - deleted the `query` request parameter `useRegex`
  - added the new optional `query` request parameter `@{attributeName}`
  - added the new optional `query` request parameter `primaryName`
  - added the new optional `query` request parameter `regex`
  - added the new optional `query` request parameter `state`
  - added the optional property `description` to the response with the `401` status
  - added the optional property `error` to the response with the `401` status
  - added the optional property `objects` to the response with the `200` status
- **2023-02-28** `910d3ad08e09`: 2 info
  - api operation id `getObjects` was added
  - added the non-success response with the status `401`
- **2023-02-23** `9c09a2aad349`: 1 breaking, 5 warning, 5 info
  - for the `query` request parameter `topLevelOnly`, default value `false` was removed
  - deleted the `query` request parameter `@{attributeName}`
  - deleted the `query` request parameter `primaryName`
  - deleted the `query` request parameter `regex`
  - deleted the `query` request parameter `state`
  - removed the optional property `objects` from the response with the `200` status
  - api operation id `getObjects` removed and replaced with ``
  - added the new optional `query` request parameter `@custom_attribute_name`
  - added the new optional `query` request parameter `useRegex`
  - for the `query` request parameter `parent`, the type was generalized from `integer` to `string`, and format from `int64` to no format
  - removed the non-success response with the status `401`

---

[Operation](https://skmtc.dev/netxms/apis/netxms-rest-api/docs/objects/get.md) - [API](https://skmtc.dev/netxms/apis/netxms-rest-api.md) - [Page](https://skmtc.dev/netxms/apis/netxms-rest-api/changes/objects/get)