Door/Window Activity

How often doors and windows were opened, counted by contact sensors, per room or floor.

Measurement	Data keyed by
room_door_window_activity	room_id
floor_door_window_activity	floor_id

Intervals: 1m, 15m, 30m, 1h, 1d. Max range: 180 days; see Query Limits.

Fields

Field	Description
open_count	Number of times a door or window was opened in the window

Each point also carries location metadata.

Example: daily openings per room on a floor

curl -X POST https://api-integrations.butlr.io/api/v1/reporting \
  -H "Authorization: Bearer [insert access_token here]" \
  -H "Content-Type: application/json" \
  -d '{
    "measurements": ["room_door_window_activity"],
    "items": ["space_XXXX"],
    "start": "2026-09-14",
    "stop": "2026-09-21",
    "timezone": "America/New_York",
    "interval": "1d",
    "fields": ["room_name", "open_count"]
  }'

Returns one array per room, keyed by room_id, with one point per day.