Observation Data

WiFi Devices

type: DevicesSeen

{
  {
    "version": "2.0",
    "secret": "supersecret",
    "type": "DevicesSeen",
    "data": {
        "apMac": "00:18:0a:13:dd:b0",
        "apFloors": [],
        "apTags": [
            "dev",
            "entrance",
            "office"
        ],
        "observations": [
            {
                "ipv4": "/192.168.0.38",
                "location": {
                    "lat": 51.5355157,
                    "lng": -0.06990350000000944,
                    "unc": 1.233417960754815,
                    "x": [],
                    "y": []
                },
                "seenTime": "2016-09-24T00:06:23Z",
                "ssid": ".interwebs",
                "os": null,
                "clientMac": "18:fe:34:fc:5a:7f",
                "seenEpoch": 1474675583,
                "rssi": 47,
                "ipv6": null,
                "manufacturer": "Espressif"
            },
            {
                "ipv4": "/192.168.0.15",
                "location": {
                    "lat": 51.5355157,
                    "lng": -0.06990350000000944,
                    "unc": 1.5497743004111961,
                    "x": [],
                    "y": []
                },
                "seenTime": "2016-09-24T00:06:40Z",
                "ssid": ".interwebs",
                "os": "Generic Linux",
                "clientMac": "74:da:38:56:0a:80",
                "seenEpoch": 1474675600,
                "rssi": 47,
                "ipv6": null,
                "manufacturer": "Edimax Technology"
            }
        ]
    }
}

Parameters

Name Format Description
apMac string MAC address of the observing AP
apTags [string] JSON array of all tags applied to the AP in dashboard
apFloors [string] JSON array of all floorplan names on which this AP appears
clientMac string Device MAC

 Location API sends the raw client MAC address and is up to the receiving service to hash or modify the data before storage if data privacy is desired.
ipv4 string Client IPv4 address and hostname, in “hostname/address” format; only “/address” if no hostname, null if not available
ipv6 string Client IPv6 address and hostname, in “hostname/address” format; only “/address” if no hostname, null if not available
seenTime ISO 8601 date string Observation time in UTC; example: “1970-01-01T00:00:00Z”
seenEpoch integer Observation time in seconds since the UNIX epoch
ssid string Client SSID name; null if the device is not connected
rssi integer Device RSSI as seen by AP
manufacturer string Device manufacturer; null if manufacturer could not be determined
os string Device operating system; null if the OS could not be determined
location location Device geolocation; null if location could not be determined
lat decimal Device latitude in degrees N of the equator
lng decimal Device longitude in degrees E of the prime meridian
unc decimal Uncertainty in meters
x [decimal] JSON array of x offsets (in meters) from lower-left corner of each floorplan
y [decimal] JSON array of y offsets (in meteres) from lower-left corner of each floorplan

Bluetooth Devices

type: BluetoothDevicesSeen

{
  {
  "version": "2.0",
  "secret": "supersecret",
  "type": "BluetoothDevicesSeen",
  "data": {
    "apMac": "88:15:44:aa:a9:26",
    "apFloors": [    
    ],
    "apTags": [    
    ],
    "observations": [
      {
        "location": {
          "lat": 52.376515264636,
          "lng": 4.9240433145314,
          "unc": 48.999999998421,
          "x": [         
          ],
          "y": [        
          ]
        },
        "seenTime": "2017-08-10T12:03:43Z",
        "clientMac": "20:91:48:33:68:23",
        "seenEpoch": 1502366623,
        "rssi": -70
      }
    ]
  }
}

Parameters

Name Format Description
apMac string MAC address of the observing AP.
apTags [string] JSON array of all tags applied to the AP in dashboard.
apFloors [string] JSON array of all floorplan names on which this AP appears.
clientMac string Device MAC
seenTime ISO 8601 date string Observation time in UTC; example: “1970-01-01T00:00:00Z”
seenEpoch integer Observation time in seconds since the UNIX epoch.
rssi integer Device RSSI as seen by AP.
location location Device geolocation; null if location could not be determined.
lat decimal Device latitude in degrees N of the equator.
lng decimal Device longitude in degrees E of the prime meridian.
unc decimal Uncertainty in meters.
x [decimal] JSON array of x offsets (in meters) from lower-left corner of each floorplan.
y [decimal] JSON array of y offsets (in meters) from lower-left corner of each floorplan.