Skip to main content

Concepts

How the platform works, and the parts worth understanding before you model your integration. These apply to both the GraphQL API and webhooks.

  • Available data — the space, sensor, occupancy, readings, sightings, analytics, and heatmap datasets, with the limits and retention for each.
  • How sensors map to spaces — why area sensors have no space association, how sightings become per-space occupancy, and what that means for your integration.
  • How occupancy is determined — how sightings become occupancy state, why analytics numbers differ from live ones, and which filters are applied.
  • Joining data to your own system — how XY Sense identifiers, timestamps, and floor plan coordinates behave, so you can line our data up with yours.
  • Choosing a data source — webhooks or GraphQL, live occupancy or analytics, and what raw history is available.