Skip to content
All recipes

Get an OS version report for your whole fleet

Pull device information from Prism and count devices by operating system version for each device family.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
Apple, Windows, Android
Effect
Read-only
Agent access
Iru MCP or the Iru API

Before you start

  • An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
  • Devices enrolled in Iru.

Prompt for your agent

Pull device information for every device in Iru from Prism with GET /api/v1/prism/device_information. The call returns at most 300 records per request, so page through the results with limit and offset until you have them all. Group the devices by device__family and os_version, and show how many devices run each version. Tell me whether you used os_version or display_os_version, and flag any devices where the field is empty. I will tell you which version counts as current, so list the devices running anything older once I do.

Steps

  1. Pull the Prism device information category

    The Devices category holds general information about your enrolled devices. Each row names the device family in device__family and carries os_version, os_build and display_os_version.

    A hard limit of 300 device records applies to each request, so the agent pages with limit and offset.

    GET/api/v1/prism/device_information

    Source: Prism

  2. Count devices by version

    Have the agent group the rows by device__family and os_version. The docs don't define the difference between os_version and display_os_version, so ask the agent to say which one it used.

    Source: Iru API: Prism Device Information

  3. List the devices behind the old versions

    The response lists installed versions only, so tell the agent which version you consider current. It then lists each older device by name, serial number and assigned user.

    In the web app, open Devices, select the Prism tab and stay on the Devices category.

    Source: Prism

Common pitfalls

  • Prism collects device data every 24 hours on Apple platforms and daily on Windows. Android reports when something changes on the device.
  • The response doesn't say which OS version is current. You supply that version.
  • A Null attribute doesn't apply to the device platform.

FAQ

Which API call returns OS versions?

GET /api/v1/prism/device_information returns device attributes, including os_version, os_build and display_os_version.

How many devices does one request return?

At most 300. The agent pages through larger fleets with limit and offset.

How current is the data?

Prism collects device data every 24 hours on Apple platforms and daily on Windows. Android reports when something changes on the device.

Does it cover Windows and Android?

Yes. The Devices category covers Apple, Windows and Android devices.

Next steps

Sources

Stay up to date

Iru's bi-weekly collection of articles, videos, and research to keep IT & Security teams ahead of the curve.