Butlr Data Center API

The Butlr Data Center API gives an application read-only access to the halls, sensors, raw thermal frames, statistics, events, and alerts owned by one Data Center organization.

Get a token

Create an expiring credential from your organization in Data Center.

Read raw thermal data

Discover sensors, then retrieve timestamped 40 x 60 thermal matrices.

Run an end-to-end example

Copy a complete Shell, Python, or JavaScript integration.

Production endpoint

https://api.datacenter.butlr.io

All requests require a bearer token whose prefix is dc_live_. The server binds the token to its organization; a client cannot choose or override that organization in a header, query parameter, GraphQL argument, or resource ID.

Tip

Organization API Tokens are read-only. GraphQL mutations, token-management routes, uploads, camera/media operations, and all unlisted routes are denied.

Current API scope

• Discover the token’s organization, halls, and registered sensors with GraphQL.
• Read archived raw thermal frames for a sensor.
• Read thermal statistics and derived events.
• List alerts and retrieve alert context.

The current raw-frame endpoint reads the archive tier. It is suitable for synchronized polling and historical windows, but it is not a WebSocket stream.

Note

The older /v1/customer/thermal/* routes and customer WebSocket are temporary evaluation interfaces. New integrations should use the organization-scoped API described here.