Skip to main content
GET
List SIMs (devices)

Authorizations

Authorization
string
header
required

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

orgid
integer

Filter results to this organization ID

limit
integer

Maximum number of results to return (max 5000)

Required range: x <= 5000
Example:

50

startafter
integer

Return results after the record with this ID (cursor-based pagination)

slim
boolean

When set to 1, return a compact response with fewer fields

withlocation
boolean

When true, include last known location data in each SIM record (default: true)

states
string

Comma-separated list of SIM states to filter by (e.g. LIVE,PAUSED-USER,CONNECTED)

ids
string

Comma-separated list of device IDs to filter by

tagid
integer

Filter results to SIMs with this tag ID

tagids
string

Comma-separated list of tag IDs to filter by

tagname
string

Filter results to SIMs with this tag name

name
string

Filter results to SIMs matching this exact name

imei
string

Filter results to devices with this IMEI

linkid
integer

Filter results to devices with this cellular link ID

linkids
string

Comma-separated list of profile cellular link IDs to filter by

planid
integer

Filter results to SIMs subscribed to this data plan ID

iccid
string

Filter results to SIM profiles with this ICCID

iccids
string

Comma-separated list of ICCIDs to filter by

sim
string

Alias for iccid — filter results to devices with this ICCID

sims
string

Alias for iccids — comma-separated list of ICCIDs to filter by

imsi
string

Filter results to SIM profiles with this IMSI

msisdn
string

Filter results to devices with this MSISDN

simcardid
integer

Filter results to devices with this SIM card ID

eid
string

Filter results to SIMs with this EID

eids
string

Comma-separated list of EIDs to filter by

eidrange
string

Filter by EID range in "start-end" format

showHidden
integer

When true, include hidden devices in results

phone
string

Filter results to SIMs with this phone number

tunnelable
integer

Filter results to SIMs with this tunnelable flag value

Response

OK

success
boolean

Indicates whether the request was successful.

Example:

true

limit
integer
size
integer
continues
boolean
lastid
integer

ID of the last record returned, for cursor-based pagination

data
object[]