Developer API · live

Your data — and your controls — in your systems.

A clean REST API over the same live data behind the dashboard: readings, runtime, alerts, and full control — set points, on/off, and schedules — with scoped, per-tenant keys. Pull it into your ERP, your BI, or your own app.

Base URL https://api.tempking.co/v1 · Bearer auth · JSON

Read the docsGet an API key
What you can do

Read everything. Control anything. Get pushed the rest.

◈

Live telemetry

Current temperature and state, temperature history, and daily compressor runtime for every unit — the same data the dashboard shows.

Readings · history · runtime
◐

Control from your stack

Change a set point, force a unit on or off, or push a schedule straight from your ERP or automation. Read-write keys only — and the compressor short-cycle guardrail always applies.

Set point · on/off · schedules
!

Signed webhooks

Register a URL and we POST an HMAC-signed event the moment an alert opens or resolves — no polling required.

alert.opened · alert.resolved
⛨

Secure by design

Per-account scoped keys, read-only unless you opt in, rate-limited, and every change audit-logged.

Scoped · rate-limited · audited
Authentication

One key. Only your data.

Generate a key per account in the dashboard. Every request is a Bearer token that can only ever see its own account's sites and units — never another tenant's. Rotate or revoke it anytime.

  • →Scoped by design — a key inherits the same site/unit access model as a user.
  • →Read-only by default — control endpoints (set point, on/off, schedules) require a key you explicitly mark read-write.
  • →Rate-limited & logged — every call is metered and auditable.
# latest reading for a unit
curl https://api.tempking.co/v1/units/8c94df587e24/reading \
  -H "Authorization: Bearer tk_live_…"

{
  "unit": "Back inventory",
  "site": "MIA - Filter King",
  "tempF": 72.4,
  "setpointF": 72,
  "acState": "on",
  "online": true,
  "lastReading": "2026-07-08T16:24:06Z"
}
Endpoints

Everything the dashboard sees, over REST.

GET/v1/sitesYour sites + unit counts
GET/v1/units/:id/readingLatest temp & state
GET/v1/units/:id/historyTemperature series
GET/v1/units/:id/runtimeDaily AC runtime
GET/v1/alertsOpen & resolved alerts
POST/v1/units/:id/setpointSet the target temp · read-write
POST/v1/units/:id/overrideForce on / off / auto · read-write
PUT/v1/units/:id/scheduleSet a schedule · read-write
POST/v1/webhooksSigned alert events to your URL

v1 is live. Full interactive reference — every endpoint, parameters, and how to verify the webhook signature — at api.tempking.co/docs.

Developer API · live

Build on your temperature data.

Readings, runtime, alerts — and control — in your stack. Grab a key from the dashboard and start building.

Get an API keyRead the docs