Ping Telemetry Data
Whenever we receive communication related to device, it is logged as a ping
POST /controllers/SmartDevicePing.ashx?action=list
List Properties
All transaction APIs return Asset/ Location related common attributes. Attributes specific to this API are:
| Property | Type | Description |
|---|---|---|
| Latitude | decimal | Latitude (non zero if Latitude could be determined) |
| Longitude | decimal | Longitude (non zero if Longitude could be determined) |
| Accuracy | decimal | Accuracy (confidence level in meters on latitude/ longitude accuracy) |
| RSSI | int | RSSI (if BLE advertisement - BLE RSSI, if Cellular transmission Cellualr RSSI) |
| AdvertisementInfo | string | Additional information such as Door status, events available etc. |
| AppVersion | string | Firmware/ Application version numbers |
🧩 Ping List API (Response)
GET /Controllers/SmartDevicePing.ashx?action=list&start=0&limit=50&asArray=0
Captures metadata from smart device ping events, including device identifiers, location details, signal information, battery status, and associated asset or distributor data.
| Field Name | Type | Description |
|---|---|---|
| SmartDeviceId | Integer | ID of the smart device |
| GatewayId | Integer | ID of the gateway device |
| DeviceSerial | String | Serial number of the smart device |
| GatewaySerialNumber | String | Serial number of the gateway |
| GatewayMac | String | MAC address of the gateway |
| MacAddress | String | MAC address of the smart device |
| EventId | Integer | Event identifier (default is 0 for pings) |
| EventTime | DateTime | Local timestamp of ping event |
| EventTimeUtc | DateTime | UTC timestamp of ping event |
| FirstSeen | DateTime | First seen timestamp (same as EventTime) |
| AssetId | Integer | ID of the asset linked to the ping |
| AssetSerialNumber | String | Serial number of the asset |
| AssetTypeId | Integer | ID of the asset type |
| AssetType | String | Model/type of the asset |
| SmartDeviceTypeId | Integer | ID of the smart device type |
| SmartDeviceType | String | Name/model of the smart device |
| LocationId | Integer | ID of the location |
| Location | String | Name of the location |
| LocationCode | String | Internal location code |
| LocationCity | String | City of the location |
| LocationPostalCode | String | Postal code of the location |
| TimeZoneId | Integer | ID of the timezone |
| TimeZoneValue | DateTime | Display label of the timezone |
| Rssi | Integer | Signal strength (Received Signal Strength Indicator) |
| Latitude | Float | GPS latitude |
| Longitude | Float | GPS longitude |
| Accuracy | Float | GPS accuracy in meters |
| ChargingStatus | Boolean | Whether the device is charging |
| HubBatteryLevel | Integer | Battery level of the hub device |
| CoolerState | Integer | Status/state of the cooler |
| UpTime | Integer | Uptime since last boot (in seconds) |
| AppVersion | String | Version of the smart device application |
| AdvertisementInfo | Integer | BLE Advertisement info (if applicable) |
| AdvertisementData | String | Raw advertisement string (if applicable) |
| Distance | Float | Distance to beacon in meters (if shown) |
| ShowDistance | Boolean | Whether distance is displayed |
| DistributorName | String | Name of the distributor associated with the asset |
| MarketName | String | Market name |
| Classification | String | Classification label of the location |
| LocationRoute | String | Sales/delivery route |
| PrimarySalesRep | String | Assigned primary sales representative |