Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- iPhone or iPad devices enrolled in Iru.
Prompt for your agent
Pull cellular data for iPhone and iPad devices in Iru from Prism with GET /api/v1/prism/cellular, using the device_families parameter. The call returns at most 300 records per request, so page through the results with limit and offset until you have them all. For each device, show its name, serial number, cellular_technology and the carrier in slot 1 and slot 2 (current_carrier_network_slot_1 and current_carrier_network_slot_2). Also show data_roaming_enabled, voice_roaming_enabled and personal_hotspot_enabled. Then count devices per carrier. Leave out IMEI, ICCID and phone numbers unless I ask for them. Tell me which fields you used for the carrier.
Steps
Pull the Prism cellular category
The category holds cellular details for iOS and iPadOS devices, including dual-SIM Slot 1 and Slot 2 data such as carrier, roaming, personal hotspot, IMEI, ICCID and EID.
A hard limit of 300 device records applies to each request, so the agent pages with
limitandoffset.GET/api/v1/prism/cellularSource: Prism
List carriers and roaming settings
Each row has one set of fields per SIM slot, such as
current_carrier_network_slot_1andcurrent_carrier_network_slot_2. The device-level fieldsdata_roaming_enabled,voice_roaming_enabledandpersonal_hotspot_enabledshow the roaming and hotspot settings.Have the agent count devices per carrier across both slots and name the fields it used.
Source: Iru API: Prism Cellular
Review the results
Check for devices on an unexpected carrier or with roaming turned on, and for devices with no carrier value. In the web app, open Devices, select the Prism tab, then open the Cellular category.
Source: Prism
Common pitfalls
- Prism collects cellular data every 24 hours through MDM, so a SIM change can take that long to show.
- The category covers iOS and iPadOS only.
- Many carrier fields can come back null, as in the Prism docs example, so ask the agent to say how many devices had no carrier value.
FAQ
Which API call returns carrier data?
GET /api/v1/prism/cellular returns cellular attributes from Prism, with one set of fields for each SIM slot.
Which devices does it cover?
iOS and iPadOS devices.
How often does Prism collect cellular data?
Every 24 hours, through MDM.
Can I limit the call to iPhone and iPad?
Yes. The call takes a device_families parameter, and the Prism docs example uses values such as Mac, iPhone, iPad and tvOS.