NinjaOne icon

NinjaOne

Ninja One Public API documentation. <br><br>See also: <br> <a href="https://resources.ninjarmm.com/API/Ninja+RMM+Public+API+v2.0.5+Device+Filter+Syntax.pdf">Device Filter syntax</a><br><a href="https://app.ninjarmm.com/apidocs-beta/core-resources/articles/webhooks/overview">Webhooks</a>

Actions309

System → List devices

AI-generated

Summary

Retrieve a list of devices from the NinjaOne system with optional filtering, pagination, and custom request modifications.

Inputs

  • Return All — Boolean flag to return all devices across all pages or just a single page.
  • Additional Fields — Optional parameters including device filter ('df'), limit on number of devices ('pageSize'), and cursor for pagination ('after').
  • Options — Additional request customizations such as arbitrary JSON body merges ('Custom Body'), extra HTTP headers ('Custom Headers'), query parameter filters, batching settings, debug flag, pagination configuration (mode, parameters, limits), and request timeout.

Output shape

a list (array) of device objects as returned by the NinjaOne API

The returned data shape depends on the API response and configured pagination. When 'Return All' is false, only one page of results is returned according to pagination settings. Enabling 'Debug' includes request details in the output. Pagination options allow controlling how the node traverses pages (offset, cursor, or URL-based). Custom body and header inputs override or augment standard parameters.

Examples

Example 1: Fetch up to 50 devices on the first page without filters, returning only the initial set.

Return All = false, Additional Fields.pageSize = 50

Example 2: Fetch all devices with a specific device filter, handling pagination cursor-based.

Return All = true, Additional Fields.df = 'filterValue', Options.Pagination.Mode = 'cursor', Pagination parameters set accordingly.

Links

Discussion