Widgets and badges
Show the power state of your queue or region on a website, in a README or in a smart home. No key, no sign-up.
Set up your badge
The size only affects the iframe code: the badge has its own size.
Live preview
Pick a region (and a queue) to see the badge and the card.
Badge
Card (iframe)
For a website: iframe card and badge
The card is a separate page that may be embedded. Paste the code where the widget should appear.
……README, forums, chats
………Smart home and scripts
The JSON status can be read from Home Assistant, Node-RED, Homebridge or a plain script. Poll no more often than once every 1–2 minutes.
……Fields of /status: state, class, plan_status, restore_at, next_outage_at, updated_at, stale, source. The state unknown means “no data”, not “power on”.
Limits and honest caveats
- The server recomputes data about every 30 seconds, but browsers and proxies may keep a badge cached for a few minutes. That is fine for a page, not for automation.
- Limits are shared with the API: 600 reads per minute per IP address. For a website the visitor’s browser requests the badge, so the limit applies to the visitor, not to you. Server-side polling more often than once a minute needs a key: see “For developers”.
- This is not an official source and no guarantee of supply. The state per an operator schedule may differ from reality; the flag
stale(data older than 45 minutes) is shown on the card. - Do not build automatic decisions on this where people’s or equipment’s safety depends on it (medical devices, generators, alarms).
- There are no native iOS or Android home screen widgets. There are the badge, the card, the API and the Telegram bot.
- The badge shows an aggregate for a queue or region. We never show individual houses or individual sensors.