Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- The app name, or the app name and the version you are looking for.
Prompt for your agent
Pull the apps installed on my devices from Prism with GET /api/v1/prism/apps. Find every device that has [app name] installed and, if I give a version, only the ones on [version]. For each match, show the device name, the user's email, the app name and the version. The call returns at most 300 records per request, so keep paging with limit and offset until you have read every record, and tell me the total you read. Tell me which fields and which filter you used to match the app and the version, since I want to check them.
Steps
Pull the Prism Apps category
Prism's Apps category holds the application inventory for iOS, iPadOS, tvOS, visionOS and macOS devices. The API call returns one record per app per device, with fields such as
device__name,device__user_email,serial_number,name,version,short_version,bundle_idandpath.The call accepts a
filterparameter with a JSON object and adevice_familiesparameter such asMac,iPhone,iPad,tvOS. Have the agent say which filter it sent and which field it matched the app name and version against.GET/api/v1/prism/appsSource: Prism
Page through every record
A request returns at most 300 records, and the response carries a
total. Have the agent keep paging withlimitandoffsetuntil it has read that many records, so no device is missing from your list.Source: Iru API: Prism Apps
Read the match list
Check that every row shows the version you asked about. To get the same view without an agent, open the Apps category in Prism and use + Filter, then select Export CSV, choose Current View and select Start export.
Source: Prism
Common pitfalls
- Prism collects Apps data every 24 hours on iOS, iPadOS, tvOS and visionOS devices and near-instantly on macOS, so an iPhone can show an older app version than the one it runs now.
- Apps data covers Apple devices. The docs list no Windows or Android Apps category in Prism.
- Versions come back as strings such as
versionandshort_version, so ask the agent which one it matched before you trust a version comparison.
FAQ
Which API call lists the apps installed on my devices?
GET /api/v1/prism/apps returns the applications installed on macOS, iOS, iPadOS and tvOS devices.
How many records does the apps call return at once?
A request returns at most 300 records. Page with limit and offset until you have read the total.
Does it cover Windows devices?
No. The Prism Apps category covers iOS, iPadOS, tvOS, visionOS and macOS devices, and the docs list no Windows Apps category.
How current is the app version data?
Prism collects Apps data every 24 hours on iOS, iPadOS, tvOS and visionOS devices and near-instantly on macOS.