Skip to main content
GET
/
devices
/
pages
List devices (paginated)
curl --request GET \
  --url https://dashboard.hologram.io/api/1/devices/pages \
  --header 'Authorization: Basic <encoded-value>'
{
  "success": true,
  "limit": 123,
  "size": 123,
  "continues": true,
  "data": [
    {
      "startAfterId": 123
    }
  ]
}

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:

5000

​
states
string

Comma-separated list of network states to filter by.

​
deviceids
string

Comma-separated list of device IDs to include

​
tagid
integer

Filter results to devices with this tag ID

​
tagids
string

Comma-separated list of tag IDs to filter by

​
linkids
string

Comma-separated list of cellular link IDs to filter by

​
sims
string

Comma-separated list of SIM identifiers to filter by

​
simrange
string

SIM range to filter by, formatted as start-end

​
devicesPerPage
integer

Number of devices per page; used to compute page boundary IDs. Defaults to limit minus 1 if not provided.

​
showHidden
integer

When true, include hidden devices in results

Response

OK

​
success
boolean

Indicates whether the request was successful.

Example:

true

​
limit
integer

Maximum number of results requested

​
size
integer

Number of page boundaries returned

​
continues
boolean

Whether more results exist beyond this page

​
data
object[]

Page boundary device IDs. Pass each startAfterId as the startafter parameter to GET /devices to fetch that page.