Skip to content
All recipes

List carriers and cellular settings on iPhone and iPad

Pull cellular data from Prism for iPhone and iPad and list each device's carrier, roaming state and personal hotspot setting for both SIM slots.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
iOS, iPadOS
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).
  • 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

  1. 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 limit and offset.

    GET/api/v1/prism/cellular

    Source: Prism

  2. List carriers and roaming settings

    Each row has one set of fields per SIM slot, such as current_carrier_network_slot_1 and current_carrier_network_slot_2. The device-level fields data_roaming_enabled, voice_roaming_enabled and personal_hotspot_enabled show 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

  3. 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.

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.