Skip to main content
GET
List 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 device record (default: true)

states
string

Comma-separated list of device 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 devices with this tag ID

tagids
string

Comma-separated list of tag IDs to filter by

tagname
string

Filter results to devices with this tag name

name
string

Filter results to devices 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 cellular link IDs to filter by

planid
integer

Filter results to devices subscribed to this data plan ID

iccid
string

Filter results to devices 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 devices with this IMSI on their cellular link

msisdn
string

Filter results to devices with this MSISDN on their cellular link

simcardid
integer

Filter results to devices with this SIM card ID

eid
string

Filter results to devices 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 devices with this phone number

tunnelable
integer

Filter results to devices 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[]