aid: butlr
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/butlr.png
name: Butlr
description: 'Butlr is an AI platform for privacy-first, heat-based (thermal) occupancy
  sensing that turns anonymous people-sensing into real-time space-utilization insight
  for workplaces, senior living, higher education, retail, and smart buildings. Its
  camera-free thermal sensors capture no personally identifiable information while
  powering occupancy, traffic, presence-time, and heatmap analytics. Butlr exposes
  an API-first platform: a GraphQL asset-management API for sites, buildings, floors,
  rooms, zones, hives, and sensors; a RESTful Reporting API (v3) for historical
  time-series occupancy; real-time webhooks for detections, traffic, and occupancy
  events; and an official Model Context Protocol (MCP) server for agent access. The
  company reports 30,000+ deployed sensors generating a billion data points daily
  across 100M+ square feet in 22 countries.'
url: https://raw.githubusercontent.com/api-evangelist/butlr/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- foundry-group
x-tier: stub
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-18'
tags:
- Company
- Sensors
- Occupancy
- People Sensing
- Smart Buildings
- Spatial Intelligence
- IoT
- GraphQL
- Webhooks
- Real Estate
apis:
- aid: butlr:butlr-graphql-api
  name: Butlr GraphQL API
  tags:
  - Assets
  - Sites
  - Buildings
  - Floors
  - Rooms
  - Zones
  - Hives
  - Sensors
  - Tags
  - Webhooks
  humanURL: https://docs.butlr.io/asset-management/graphql-api-overview
  baseURL: https://api.butlr.io/api/v3/graphql
  properties:
  - url: https://docs.butlr.io/asset-management/graphql-api-overview
    type: Documentation
  - url: https://graphql-docs.butlr.io/graphql/
    type: APIReference
  - url: https://graphql-docs.butlr.io/graphql/
    type: GraphQL
  description: The Butlr GraphQL API manages spatial assets and their configuration
    across the organization hierarchy - sites, buildings, floors, rooms, zones, hives,
    and sensors - plus asset tags and self-service webhook subscriptions. It supports
    querying and mutating (create/update/delete) resources with fine-grained field
    selection and filtering, and is the control plane for the occupancy platform.
- aid: butlr:butlr-reporting-api
  name: Butlr Reporting API
  tags:
  - Occupancy
  - Traffic
  - Presence Time
  - Heatmap
  - Statistics
  - Time Series
  - Historical
  - Floors
  - Rooms
  - Zones
  humanURL: https://docs.butlr.io/historical-occupancy/reporting-api-overview
  baseURL: https://api.butlr.io/api/v3/reporting
  properties:
  - url: https://docs.butlr.io/historical-occupancy/reporting-api-overview
    type: Documentation
  - url: https://docs.butlr.io/historical-occupancy/faqs
    type: APIReference
  description: The Butlr Reporting API is a RESTful, time-series occupancy API for
    historical space-utilization analysis. A POST query against a windowing/filter
    body returns aggregated floor, room, and zone occupancy, entryway traffic,
    presence time, per-interval statistics, and heatmaps with configurable windows
    (1m/1h/1d), aggregation functions (mean/max/sum/median), timezones, and tag-based
    grouping.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://www.butlr.com
- type: DeveloperPortal
  url: https://docs.butlr.io
- type: Documentation
  url: https://docs.butlr.io
- type: APIReference
  url: https://graphql-docs.butlr.io/graphql/
- type: GettingStarted
  url: https://docs.butlr.io/getting-started
- type: Support
  url: https://support.butlr.io
- type: Blog
  url: https://www.butlr.io/blog
- type: GitHubOrganization
  url: https://github.com/butlrtechnologies
- type: SignUp
  url: https://app.butlr.io
- type: Login
  url: https://app.butlr.io
- type: TermsOfService
  url: https://www.butlr.io/legal/tc
- type: PrivacyPolicy
  url: https://www.butlr.io/legal/privacy-policy
- type: Authentication
  url: authentication/butlr-authentication.yml
- type: OAuthScopes
  url: scopes/butlr-scopes.yml
- type: MCPServer
  url: mcp/butlr-mcp.yml
- type: LLMsTxt
  url: llms/butlr-llms.txt
- type: Packages
  url: packages/butlr-packages.yml
- type: SDKs
  url: packages/butlr-packages.yml
- type: WellKnown
  url: well-known/butlr-well-known.yml
- type: Webhooks
  url: asyncapi/butlr-webhooks.yml
- type: AsyncAPI
  url: asyncapi/butlr-events-asyncapi.yml
- type: ChangeLog
  url: changelog/butlr-changelog.yml
- type: Lifecycle
  url: lifecycle/butlr-lifecycle.yml
- type: Deprecation
  url: lifecycle/butlr-lifecycle.yml
- type: Conventions
  url: conventions/butlr-conventions.yml
- type: Conformance
  url: conformance/butlr-conformance.yml
- type: DataModel
  url: data-model/butlr-data-model.yml
- type: VulnerabilityDisclosure
  url: security/butlr-vulnerability-disclosure.yml
- type: Security
  url: security/butlr-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/butlr-domain-security.yml
- type: AgentSkill
  url: skills/_index.yml
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence