List things by model
GEThttps://apis.<domain>/iot/models/:modelId/things
Authorization: http
name: bearerTokentype: httpscheme: bearerin: headerdescription: Authorization Header: `Authorization: Bearer <user_token>`
Retrieves list of things belonging to specified model with pagination metadata.
Authorization Action:
core:models:getThings
Request
Path Parameters
modelId uuidrequired
Unique model identifier.
Query Parameters
offset integer
Number of items to skip during retrieval.
limit integer
Possible values: >= 1 and <= 100
Default value: 10
Size of the subset to retrieve.
order string
Possible values: [name, id]
Default value: id
Order type.
dir string
Possible values: [asc, desc]
Default value: desc
Order direction.
Responses
- 200
- 400
- 401
- 404
- 422
- 500
Data retrieved.
- application/json
- Schema
- Example (from schema)
Schema
things object[]
total integer
Total number of items.
offset integer
Number of items to skip during retrieval.
limit integer
Maximum number of items to return in one page.
{
"things": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"key": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"metadata": {}
}
],
"total": 0,
"offset": 0,
"limit": 0
}
Failed due to malformed query parameters.
Missing or invalid access token provided.
Model does not exist.
Database can't process request.
Unexpected server error.
- application/json
- Schema
Schema
- string byte
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L -X GET 'https://apis.<domain>/iot/models/:modelId/things' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'