AppSys N-Central icon

AppSys N-Central

Interact with the N-Central API

Device → Get by Org Unit

AI-generated

Summary

Retrieve a list of devices associated with a specified organization unit in N-Central, optionally applying a device filter and pagination options.

Inputs

  • Org Unit ID (required) — The ID of the organization unit to retrieve devices from.
  • Return All — Whether to return all matching devices or paginate the results.
  • Limit — Maximum number of device results to return when pagination is used (1 to 1000).
  • Device Filter — An optional device filter to apply for narrowing down the device list.
  • Options — Additional options including sorting field, sort order (Ascending or Descending), and page number for pagination.

Output shape

a list of device records (JSON objects) representing devices under the specified organization unit, potentially filtered and paginated.

When 'Return All' is true, all matching devices are returned across all pages. When false, results are limited by 'Limit' and 'Page Number'. If a device filter is specified, only devices matching the filter are returned.

Examples

Example 1: Fetch all devices for an org unit with ID 123, returning all results without pagination.

Set 'Org Unit ID' to 123, enable 'Return All' to true, and leave 'Device Filter' empty.

Example 2: Fetch the first 50 devices for org unit with ID 456, sorted by 'deviceName' descending, applying a specific device filter with ID 10.

Set 'Org Unit ID' to 456, 'Return All' to false, 'Limit' to 50, 'Device Filter' to 10, and under 'Options' set 'Sort By' to 'deviceName' and 'Sort Order' to 'DESC'.

Links

Discussion