thing.find

The thing.find command is used to find and return a thing.

TR50 Request

{
  "cmd": {
    "command": "thing.find",
    "params": {
      "key": "mything"
    }
  }
}

Request Parameters


Name	Type	Description
key	String	Identifies the thing.
iccid	String	ICCID of the thing.
esn	String	ESN of the thing.
imei	String	IMEI of the thing.
meid	String	MEID of the thing.
imsi	String	IMSI of the thing.

TR50 Response

If the command is sent successfully a success message and the thing is returned. Otherwise, an error and error message will be returned.

{
    "1": {
        "success": true,
        "params": {
            "id": "59ef593f79028951de07ab31",
            "orgId": "599db51574e936608472ccfb",
            "ownerOrgId": "599db51574e936608472ccfb",
            "permission": "rw",
            "name": "auto:a66a07d3-8755-4133-8f13-fe6c845d8dba-iot-simple-telemetry-py",
            "key": "a66a07d3-8755-4133-8f13-fe6c845d8dba-iot-simple-telemetry-py",
            "defId": "59e6209f74e936232f36226d",
            "defName": "hdc_simple_telemetry_def",
            "tags": [
                "windows"
            ],
            "lastSeen": "2017-10-27T19:08:06.136Z",
            "lastCommunication": "2017-10-27T19:08:06.136Z",
            "locEnabled": true,
            "attrs": {
                "attribute-1": {
                    "ts": "2017-10-26T21:12:59.912Z",
                    "since": "2017-10-26T21:12:59.912Z",
                    "value": "esiczhglvhvpzmrqybsu"
                },
                "attribute-2": {
                    "ts": "2017-10-26T21:12:59.912Z",
                    "since": "2017-10-26T21:12:59.912Z",
                    "value": "wnrjoywkfhddikcodabs"
                }
            },
            "properties": {
                "property-1": {
                    "ts": "2017-10-26T21:12:59.912Z",
                    "value": 18.53
                },
                "property-2": {
                    "ts": "2017-10-26T21:12:59.912Z",
                    "value": 507.91
                }
            },
            "alarms": {
                "alarm_1": {
                    "ts": "2017-10-26T21:13:02.724Z",
                    "since": "2017-10-26T21:12:55.865Z",
                    "state": 1
                }
            },
            "apiCounts": {
                "daily": 4,
                "monthToDate": 61555,
                "total": 61555
            },
            "storage": 27641381,
            "createdBy": "AUTOREG",
            "createdOn": "2017-10-24T15:16:15.238Z",
            "updatedBy": "john.doe@telit.com",
            "updatedOn": "2017-10-25T18:06:10.189Z",
            "defKey": "hdc_simple_telemetry_def",
            "connected": false,
            "appId": true
        }
    }
}

Response Parameters


Name	Type	Description
id	String	The id of the thing.
orgid	String	The current organization id
ownerOrgid	String	If the thing definition is shared, then the ownerOrgid displays the id of the organization to which it belongs. If a thing definition is not shared then the orgid and the ownerOrgid are the same.
permission	String	The permissions for the thing in the current organization.
name	String	The name of the thing.
key	String	The key of the thing.
desc	String	The description of the thing.
defId	String	The thing definition id of the thing.
defKey	String	The thing definition key of the thing.
secTags	Array	The security tags associated with the thing.
tags	Array	The tags associated with the thing.
lastSeen	String	The last time the thing was connected.
lastCommunication	String	The last time the thing indicated that it was still connected (the keep-alive heartbeat).
locEnabled	Bool	If the thing has location tracking enabled.
loc	Object	The array containing the location information.
loc.lat	Float	The latitude of the thing.
loc.lng	Float	The longitude of the thing.
loc.heading	Float	The heading of the thing.
loc.speed	Float	The speed of the thing.
loc.altitude	Float	The altitude of the thing.
loc.fixType	String	The method used to determine the location of the thing.
loc.addr	Object	The array containing the address information.
loc.addr.streetNumber	String	The street number.
loc.addr.street	String	The street.
loc.addr.city	String	The city.
loc.addr.state	String	The state.
loc.addr.zipCode	String	The zip code.
loc.addr.country	String	The country.
attrs	Object	Lists the attribute key-value pairs with the timestamps. For more information about attributes, see Defining Attributes.
properties	Object	Lists the property key-value pairs with the timestamps. For more information about properties, see Defining Properties
data	Object	Opaque data store object.
createdBy	String	The email address of the user who created the thing.
createdOn	String	The date and time that the thing was created.
updatedBy	String	The email address of the user who last updated the thing.
updatedOn	String	The date and time that the thing was updated.
appId	String	If the appId of the thing has been set.
apiCounts.daily	Integer	The number of API calls by this Thing for the current day (estimate).
apiCounts.monthToDate	Integer	The number of API calls by this Thing since the beginning of the current month.
apiCounts.total	Integer	The number of API calls by this Thing since the beginning of time.
storage	Integer	The amount of storage a thing is using (in bytes)