---
title: "Find devices"
method: POST
path: "/configuration_manager/devices"
tags: ["Configuration Manager"]
---

# Find devices

`POST /configuration_manager/devices`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/configuration_manager/devices`
- Auth: none declared

Gets a specific subset of devices for based on given options.

## Request body

- object
  - `options` ConfigurationManagerDevicesPostRequestBodyContentApplicationJsonSchemaOptions
    - `start` integer
    - `limit` integer, required
    - `filter` ConfigurationManagerDevicesPostRequestBodyContentApplicationJsonSchemaOptionsFilter
      - `name` string
      - `address` string
      - `port` string
    - `sort` ConfigurationManagerDevicesPostRequestBodyContentApplicationJsonSchemaOptionsSortItems[]
      - `name` '-1' | '1'
      - `address` '-1' | '1'
      - `port` '-1' | '1'
    - `order` 'ascending' | 'descending'
    - `adapterType` string[]
    - `adapterId` string[]
    - `exactMatch` boolean: boolean that indicates if an exact result will be returned or not

## Response `200`

Filtered/Sorted Devices

- ConfigurationManagerGetDevicesFilteredResponse200
  - `entity` unknown
  - `total` integer
  - `unique_device_count` integer
  - `return_count` integer
  - `start_index` integer
  - `list` ConfigurationManagerDeviceDataDeviceDetails[]
    - `name` string, required
    - `authgroup` string
    - `ipaddress` string, required
    - `address` string
    - `port` string, required
    - `device-type` string, required
    - `ostype` string, required
    - `ned` string
    - `admin` boolean
    - `host` string, required
    - `actions` string[], required
    - `origins` string[]

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Configuration Manager` added
  - api tag `configurationManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/configuration_manager/devices/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)