Query Devices

Query for devices in a number of ways using available filters.

Routes#

Method	URI	Summary
GET	`/v1.0/admin/things`	Get list of all devices
GET	`/v1.0/admin/things/count`	Get count of all devices
GET	`/v1.0/admin/things/{thing_id}`	Get single user identity

Query Parameters#

Name	Source	Type	Values
application_id	`query`	string
limit	`query`	number
page	`query`	number
location_id	`query`	number
status	`query`	number
user_id	`query`	string
thing_type	`query`	string	`devices` or `gateways`

Examples#

Get all Devices for specific User**#

Example call to query devices for a user (e.g. one of our two users pulled in the previous example). In this case we'll query against robcan...@yopmail.com, user 99e86f3f-87f4-4d7e-9e87-529e16f27438:

alt text Note how we filter by a specific user_id.

curl --request GET --url https://api.iotinabox.com/v1.0/admin/things?user_id=99e86f3f-87f4-4d7e-9e87-529e16f27438 \
--header 'authorization: Bearer MyAuthTokenHere' \
--header 'content-type: application/json'

Example Response (robcan...@yopmail.com's devices):

[
  {
    "sensor_type": null,
    "created_at": "2019-05-07T23:04:25.000Z",
    "sensor_use": null,
    "thing_type": 0,
    "thing_name": "Gateway",
    "properties": "{\"codec\":\"lorawan.gateway.iotb\"}",
    "company_id": 937,
    "hardware_id": "eui-00001c497bb44...",
    "device_type_id": "36c52526-e689-11e7-80c1-9a214cf093ce",
    "application_id": "iot-solutions-canada",
    "sensor_use_id": null,
    "location_id": 890,
    "id": 70006075,
    "enabled": 1,
    "status": 0,
    "user_id": "99e86f3f-87f4-4d7e-9e87-529e16f27438",
    "parent_id": null,
    "updated_at": "2019-05-07T23:04:25.000Z",
    "cayenne_id": "75722a70-711c-11e9-9fd4-e73c33d2d42c"
  },
  {
    "company_id": 937,
    "hardware_id": "00137a1000000...",
    "device_type_id": "121f6268-e52b-11e7-80c1-9a214cf093ae",
    "sensor_type": "Open/Close",
    "created_at": "2019-05-07T23:04:45.000Z",
    "thing_type": 1,
    "sensor_use": "Door",
    "thing_name": "OCRPP",
    "properties": "{}",
    "application_id": "iot-solutions-canada",
    "id": 70006076,
    "enabled": 1,
    "sensor_use_id": null,
    "location_id": 890,
    "cayenne_id": "815f4c00-711c-11e9-9fd4-e73c33d2d42c",
    "updated_at": "2019-05-09T17:00:11.000Z",
    "user_id": "99e86f3f-87f4-4d7e-9e87-529e16f27438",
    "status": 1,
    "parent_id": null
  }
]