NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Queries → Get Software

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve software information based on specified query parameters. It is designed to fetch paginated lists of software installed on devices, filtered by criteria such as device filter, installation date range, and pagination cursor.

Common scenarios where this node is beneficial include:

  • Inventory management: Automatically retrieving software inventory data from managed devices.
  • Compliance auditing: Filtering software installed before or after certain dates to check for outdated or unauthorized software.
  • Reporting: Generating reports on software installations across an organization.

For example, you can use this node to get all software installed on devices matching a specific filter, limiting results to 100 records per page, and only including software installed after January 1, 2023.

Properties

Name Meaning
Df Device filter - a string to filter software by device identifier or name.
Cursor Cursor name - used for pagination to continue fetching subsequent pages of results.
Page Size Limit number of records per page - a number specifying how many software records to fetch per request.
Installed Before Include software installed before specified date - a date string to filter older installations.
Installed After Include software installed after specified date - a date string to filter newer installations.

Output

The node outputs JSON data containing the response from the NinjaOne API for the software query. The structure typically includes an array of software records matching the filters applied. Each record contains details about individual software installations on devices.

No binary data output is produced by this operation.

Dependencies

  • Requires an active NinjaOne API OAuth2 credential configured in n8n for authentication.
  • Depends on the NinjaOne API being accessible and the user having appropriate permissions to query software data.

Troubleshooting

  • Empty results: Ensure that the device filter and date filters are correctly set and match existing data.
  • Authentication errors: Verify that the NinjaOne API credentials are valid and have not expired.
  • Pagination issues: If using cursors, ensure the cursor value is correct; otherwise, the node may return no further data.
  • Invalid date formats: Dates must be in a format accepted by the NinjaOne API (typically ISO 8601). Incorrect formats may cause errors or empty responses.

Links and References

  • NinjaOne API Documentation (general reference): https://api.ninjaone.com/docs
  • NinjaOne OAuth2 Authentication Guide (for setting up credentials in n8n): [Refer to your internal n8n documentation or NinjaOne developer portal]

Discussion