---
title: "Search objects"
method: POST
path: "/v1/objects/search"
tags: ["Objects"]
---

# Search objects

`POST /v1/objects/search`

Search for objects matching certain criteria. Multiple criterias will be combined with logical AND.

## Request body

- object
  - `class` ObjectClass[]
  - `ipAddress` string, ip-address — IP address filter string. If provided, only objects with matching primary IP address will be returned.
  - `name` string — Name filter string. If provided, only objects with name or alias containing given string will be returned.
  - `parent` integer — Parent object ID. If provided, only child objects (both direct and indirect) of given parent object will be returned.
  - `zoneUIN` integer — Zone UIN. If provided, only objects within given zone will be returned.

## Response `200`

Successful retrieval of objects.

- ObjectSummary[]
  - `alias` string — Object alias
  - `category` integer — Object category ID
  - `class` 'AccessPoint' | 'AgentPolicyLogParser' | 'Asset' | 'AssetGroup' | 'AssetRoot' | 'BusinessService' | 'BusinessServiceProto' | 'BusinessServiceRoot' | 'Chassis' | 'Cluster' | 'Condition' | 'Container' | 'Dashboard' | 'DashboardGroup' | 'DashboardRoot' | 'Generic' | 'Interface' | 'MobileDevice' | 'Network' | 'NetworkMap' | 'NetworkMapGroup' | 'NetworkMapRoot' | 'NetworkService' | 'Node' | 'NodeLink' | 'Rack' | 'Report' | 'ReportGroup' | 'ReportRoot' | 'Sensor' | 'ServiceCheck' | 'ServiceRoot' | 'Subnet' | 'Template' | 'TemplateGroup' | 'TemplateRoot' | 'VPNConnector' | 'Zone'
  - `guid` string, uuid — Object GUID
  - `id` integer — Object ID
  - `ipAddress` InetAddress
    - `family` integer — IP address family
    - `address` integer — IP address
    - `prefixLength` integer — IP address prefix length
  - `isInMaintenanceMode` boolean — true if object is in maintenance mode
  - `isMaintenanceApplicable` boolean — true if object can be placed into maintenance mode
  - `isMaintenanceScheduled` boolean — true if object has pending scheduled maintenance
  - `name` string — Object name
  - `timestamp` string, date-time — Object last change timestamp
  - `status` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

## Other responses

- `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)