Skip to main content
GET
/
devices
/
count
Count matching devices
curl --request GET \
  --url https://dashboard.hologram.io/api/1/devices/count \
  --header 'Authorization: Basic <encoded-value>'
{
  "value": {
    "data": 6,
    "success": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.hologram.io/llms.txt

Use this file to discover all available pages before exploring further.

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
number
required
​
tagid
number

Single tag ID.

Example:

101

​
tagids
string

Comma-separated list of tag IDs.

Example:

"101,102,103"

​
linkids
string

Comma-separated list of link (profile) IDs.

Example:

"5389720,5608542"

​
states
string

Comma-separated list of network states.

Example:

"LIVE, LIVE-PENDING, PAUSED-USER, PAUSED-SYS, PAUSED-PENDING-USER, PAUSED-PENDING-SYS, INACTIVE, TEST-ACTIVATE, TEST-ACTIVATE-PENDING, DEAD, DEAD-PENDING"

​
sims
string

Comma-separated list of profile ICCIDs.

Example:

"89131300001234567890,89131300001234567891"

​
simrange
string

Range of profile ICCIDs, separated by a hyphen.

Example:

"89131300001234567890-89131300001234568000"

Response

200 - application/json

Count of devices matching the parameters given.

​
data
integer

Number of devices

​
success
boolean

Whether the request was successful or not

Example:

true