Skip to main content

Sensor connection status

Use this flow to check whether sensors are online and to understand what spaces each sensor affects.

Fetch sensor connection information​

Open in API Explorer

Example query​

query FloorSensorStatus($floorId: ID!) {
  floor(id: $floorId) {
    id
    name
    currentFloorStatus {
      status
      startDate
    }
    entrySensorInstallations {
      id
      name
      entrySensor {
        id
        externalId
        isVirtual
        connection {
          isOnline
          isOnlineChangeDate
          source
        }
      }
    }
    spaceSensorInstallations {
      id
      name
      spaceSensor {
        id
        externalId
        type {
          id
          name
        }
        connection {
          isOnline
          isOnlineChangeDate
          source
        }
      }
    }
  }
}

Example variables​

{
  "floorId": "floor-l12"
}

Example response​

{
  "data": {
    "floor": {
      "id": "floor-l12",
      "name": "Level 12",
      "currentFloorStatus": {
        "status": "Live",
        "startDate": "2026-05-14T00:00:00Z"
      },
      "entrySensorInstallations": [
        {
          "id": "esi-1",
          "name": "North Entry",
          "entrySensor": {
            "id": "entry-sensor-01",
            "externalId": "ENT-01",
            "isVirtual": false,
            "connection": {
              "isOnline": true,
              "isOnlineChangeDate": "2026-06-02T06:58:00Z",
              "source": "Heartbeat"
            }
          }
        }
      ],
      "spaceSensorInstallations": [
        {
          "id": "ssi-1",
          "name": "Room 12A Sensor",
          "spaceSensor": {
            "id": "space-sensor-01",
            "externalId": "SS-01",
            "type": {
              "id": "7187aa0d-6cc9-4c5d-8661-3861d745e664",
              "name": "Comfort"
            },
            "connection": {
              "isOnline": false,
              "isOnlineChangeDate": "2026-06-02T06:50:00Z",
              "source": "Heartbeat"
            }
          }
        }
      ]
    }
  }
}

Fetch floor spaces associated with an entry sensor​

Open in API Explorer

Example query​

query EntrySensorFloorSpaces($installationId: ID!) {
  entrySensorInstallation(id: $installationId) {
    id
    name
    entries {
      id
      name
      externalId
      entryFloorSpaces {
        invertEntryDirection
        floorSpace {
          id
          name
        }
      }
    }
  }
}

Example variables​

{
  "installationId": "esi-1"
}

Example response​

{
  "data": {
    "entrySensorInstallation": {
      "id": "esi-1",
      "name": "North Entry",
      "entries": [
        {
          "id": "entry-1",
          "name": "Inbound lane",
          "externalId": "ENTRY-IN-01",
          "entryFloorSpaces": [
            {
              "invertEntryDirection": false,
              "floorSpace": {
                "id": "room-12a",
                "name": "Room 12A"
              }
            }
          ]
        }
      ]
    }
  }
}

Fetch floor spaces associated with a space sensor​

Open in API Explorer

Example query​

query SpaceSensorFloorSpaces($installationId: ID!) {
  spaceSensorInstallation(id: $installationId) {
    id
    name
    ignoredCapabilities {
      id
      name
    }
    spaceSensor {
      id
      externalId
      type {
        id
        name
      }
    }
    spaceSensorInstallationFloorSpaces {
      ignoredCapabilities {
        id
        name
      }
      floorSpace {
        id
        name
      }
    }
  }
}

Example variables​

{
  "installationId": "ssi-1"
}

Example response​

{
  "data": {
    "spaceSensorInstallation": {
      "id": "ssi-1",
      "name": "Room 12A Sensor",
      "ignoredCapabilities": [
        {
          "id": "47c873e6-3c60-41f8-9d17-96e5639b3bde",
          "name": "Humidity"
        }
      ],
      "spaceSensor": {
        "id": "space-sensor-01",
        "externalId": "SS-01",
        "type": {
          "id": "7187aa0d-6cc9-4c5d-8661-3861d745e664",
          "name": "Comfort"
        }
      },
      "spaceSensorInstallationFloorSpaces": [
        {
          "ignoredCapabilities": [
            {
              "id": "47c873e6-3c60-41f8-9d17-96e5639b3bde",
              "name": "Humidity"
            }
          ],
          "floorSpace": {
            "id": "room-12a",
            "name": "Room 12A"
          }
        }
      ]
    }
  }
}

Notes​

  • An offline sensor is not always an incident. Check the floor status first.
  • Entry sensors affect occupancy through entries and their associated entryFloorSpaces.
  • Space sensors can be associated with more than one floor space and can ignore selected capabilities at install or per-space level.