Skip to main content

Sensor connection status

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

Check which sensors are online​

An offline sensor is not always an incident. Check the floor's currentFloorStatus first, because sensors on floors still being installed or reviewed are not yet expected to stay online.

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": "a2961d46-971f-4ce1-a66e-7ee7bdb2a204"
}

Example response​

{
  "data": {
    "floor": {
      "id": "a2961d46-971f-4ce1-a66e-7ee7bdb2a204",
      "name": "Level 12",
      "currentFloorStatus": {
        "status": "Live",
        "startDate": "2026-05-14T00:00:00Z"
      },
      "entrySensorInstallations": [
        {
          "id": "b6f1c3d7-9e42-4a58-8c60-1d2e3f4a5b6c",
          "name": "North Entry",
          "entrySensor": {
            "id": "e41a7b52-6c39-4d81-9f0a-2b3c4d5e6f70",
            "externalId": "ENT-01",
            "isVirtual": false,
            "connection": {
              "isOnline": true,
              "isOnlineChangeDate": "2026-06-02T06:58:00Z",
              "source": "Heartbeat"
            }
          }
        }
      ],
      "spaceSensorInstallations": [
        {
          "id": "9c1d5e83-2b47-4f60-a915-6d8e0f1a2b37",
          "name": "Room 12A Sensor",
          "spaceSensor": {
            "id": "3f7a2c19-8d64-4b05-9e13-7a2b5c8d0e46",
            "externalId": "SS-01",
            "type": {
              "id": "7187aa0d-6cc9-4c5d-8661-3861d745e664",
              "name": "Comfort"
            },
            "connection": {
              "isOnline": false,
              "isOnlineChangeDate": "2026-06-02T06:50:00Z",
              "source": "Heartbeat"
            }
          }
        }
      ]
    }
  }
}

Find what a sensor affects​

Which spaces a sensor influences depends on its type. Entry sensors affect occupancy indirectly, through their entries and the entryFloorSpaces those entries are associated with. Space sensors can be associated with more than one floor space, and can have individual capabilities ignored at the installation or per-space level.

Spaces served by 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": "b6f1c3d7-9e42-4a58-8c60-1d2e3f4a5b6c"
}

Example response​

{
  "data": {
    "entrySensorInstallation": {
      "id": "b6f1c3d7-9e42-4a58-8c60-1d2e3f4a5b6c",
      "name": "North Entry",
      "entries": [
        {
          "id": "c72d9f81-3a64-4e59-8b12-5d6e7f8a9b0c",
          "name": "Inbound lane",
          "externalId": "ENTRY-IN-01",
          "entryFloorSpaces": [
            {
              "invertEntryDirection": false,
              "floorSpace": {
                "id": "6e0b4c85-1f27-4d93-a8b5-3c7d9e0f1a24",
                "name": "Room 12A"
              }
            }
          ]
        }
      ]
    }
  }
}

Spaces served by 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": "9c1d5e83-2b47-4f60-a915-6d8e0f1a2b37"
}

Example response​

{
  "data": {
    "spaceSensorInstallation": {
      "id": "9c1d5e83-2b47-4f60-a915-6d8e0f1a2b37",
      "name": "Room 12A Sensor",
      "ignoredCapabilities": [
        {
          "id": "47c873e6-3c60-41f8-9d17-96e5639b3bde",
          "name": "Humidity"
        }
      ],
      "spaceSensor": {
        "id": "3f7a2c19-8d64-4b05-9e13-7a2b5c8d0e46",
        "externalId": "SS-01",
        "type": {
          "id": "7187aa0d-6cc9-4c5d-8661-3861d745e664",
          "name": "Comfort"
        }
      },
      "spaceSensorInstallationFloorSpaces": [
        {
          "ignoredCapabilities": [
            {
              "id": "47c873e6-3c60-41f8-9d17-96e5639b3bde",
              "name": "Humidity"
            }
          ],
          "floorSpace": {
            "id": "6e0b4c85-1f27-4d93-a8b5-3c7d9e0f1a24",
            "name": "Room 12A"
          }
        }
      ]
    }
  }
}