Get me things

  • 2 minute(s) read
Prev Next
Get
/v2/identity/users/me/things

Returns the list of things visible by the logged-in user.
This API allows retrieving the list of things specifying:
 - One or more conditions based on properties (all conditions are in AND).
 - The sorting criteria (also multiple).
 - The paging configuration.

Required permissions: READ_THING.

Security
HTTP
Type bearer
Header parameters
X-Servitly-Tenant
stringRequired

The name of the target tenant (e.g. acme).

Query parameters
serialNumber
string

Condition on thing serial-number.
For more details on predicates, see the payload common concepts article.

Exampleeq;SN12345
name
string

Condition on name property.
For more details on predicates, see the payload common concepts article.

Exampleeq;FooBar
thingDefinitionId
string

Condition on thing-definition id.

Exampleabcd1234
productModelId
string

Condition on product-model id.

Exampleabcd1234
productModelPartId
string

Condition on product-model-part id.

Exampleabcd1234
customerId
string

Condition on customer id.

Exampleabcd1234
locationId
string

Condition on location id.

Exampleabcd1234
PROPERTY_NAME
string

Condition on object property.
For more details on predicates, see the payload common concepts article.

Exampleproperties.propABC=eq;XYZ
assigned
boolean

The flag indicating whether to include ASSIGNED things.

ExampleTrue
unassigned
boolean

The flag indicating whether to include UNASSIGNED things.

ExampleFalse
size
integer

The number of elements to retrieve for the current page.

Minimum1.0
Example200
page
integer

The page number to retrieve (zero-based).

Minimum0.0
Example0
sort
string

The sorting criteria based on object properties.

Minimum0.0
Examplename,ASC
Responses
200

Successful operation.

Expand All
object
content
Array of object (Thing)
object
id
string
name
string
serialNumber
string
thingDefinitionId
string
productModelId
string
productModelPartId
string
gpsPosition
string
creationTimestamp
integer (int64)
activationDate
integer (int64)
lastModifiedTimestamp
integer (int64)
cloudStatus
integer
cloudStatusLastUpdateTimestamp
integer (int64)
connectionStatus
integer
connectionStatusLastUpdateTimestamp
integer (int64)
latestMetricValueTimestamp
integer (int64)
customerId
string
locationId
string
properties
object (Properties)
Example{ "foo": "abc", "bar": "123" }
property*
string additionalProperties
simIccid
string
simDetails
object (SimDetails)
simStatus
string
Valid values[ "INACTIVE", "TEST", "ACTIVE" ]
sessionStatus
string
Valid values[ "G", "A", "R" ]
sessionStartTimestamp
integer (int64)
sessionDataLastTimestamp
integer (int64)
sessionNetworkTraffic
integer
dailyTraffic
integer
monthlyTraffic
integer
lastCellId
string
lastUpdate
integer (int64)
tagIds
Array of string
string
thingDefinition
object
id
string
name
string
description
string
defaultThingName
string
nameMetricId
string
serialNumberMetricId
string
gpsPositionMetricId
string
thingDefinitionMetricId
string
superThingDefinitionId
string
parentThingDefinitionId
string
properties
object (Properties)
Example{ "foo": "abc", "bar": "123" }
property*
string additionalProperties
customer
object
id
string
name
string
country
string
timezone
string
properties
object (Properties)
Example{ "foo": "abc", "bar": "123" }
property*
string additionalProperties
creationTimestamp
integer (int64)
firstAccessTimestamp
integer (int64)
lastAccessTimestamp
integer (int64)
location
object
id
string
name
string
country
string
timezone
string
gpsPosition
string
properties
object (Properties)
Example{ "foo": "abc", "bar": "123" }
property*
string additionalProperties
customerId
string
serviceLevel
object
id
string
name
string
level
integer
alertingFeature
boolean
notificationsFeature
boolean
thingPricing
object
authorizationPricing
object
features
object
partner
object
id
string
name
string
code
string
country
string
timezone
string
customerCount
number
properties
object (Properties)
Example{ "foo": "abc", "bar": "123" }
property*
string additionalProperties
organization
object
id
string
Example1234abcd
creationTimestamp
integer (int64)
first
boolean
last
boolean
totalPages
integer
totalElements
integer
sort
string
numberOfElements
integer
size
integer
number
integer
Minimum0.0
401

User not authenticated.

object
message
string

The error response.

ExampleUser not authenticated
403

User not authorized.

object
message
string

The error response.

ExampleUser not authorized
404

Resource was not found.

object
message
string

The error response.

ExampleResource not found
429

API call rate limit exeeded.

object
message
string

The error response.

ExampleAPI call rate limit exeeded
500

Internal server error.

object
message
string

The error response.

ExampleInternal Server Error