List SIMs (devices)
Retrieve a list of SIMs (devices) with their detailed information including profile information (cellular links), session data, and metadata. SIMs are returned sorted by creation date, with the most recent SIMs appearing first. Use the limit and startafter parameters together for cursor-based pagination through large SIM lists.
Authorizations
HTTP Basic authentication using API keys. Set the username to apikey and the password to your API key. You can find your API key on the Hologram Dashboard under Account Settings.
Query Parameters
Filter results to this organization ID
Maximum number of results to return (max 5000)
x <= 500050
Return results after the record with this ID (cursor-based pagination)
When set to 1, return a compact response with fewer fields
When true, include last known location data in each SIM record (default: true)
Comma-separated list of SIM states to filter by (e.g. LIVE,PAUSED-USER,CONNECTED)
Comma-separated list of device IDs to filter by
Filter results to SIMs with this tag ID
Comma-separated list of tag IDs to filter by
Filter results to SIMs with this tag name
Filter results to SIMs matching this exact name
Filter results to devices with this IMEI
Filter results to devices with this cellular link ID
Comma-separated list of profile cellular link IDs to filter by
Filter results to SIMs subscribed to this data plan ID
Filter results to SIM profiles with this ICCID
Comma-separated list of ICCIDs to filter by
Alias for iccid — filter results to devices with this ICCID
Alias for iccids — comma-separated list of ICCIDs to filter by
Filter results to SIM profiles with this IMSI
Filter results to devices with this MSISDN
Filter results to devices with this SIM card ID
Filter results to SIMs with this EID
Comma-separated list of EIDs to filter by
Filter by EID range in "start-end" format
When true, include hidden devices in results
Filter results to SIMs with this phone number
Filter results to SIMs with this tunnelable flag value