SPAN is a San Francisco-based home energy technology company that builds smart electrical panels which replace traditional residential breaker boxes with a software-defined, controllable, and metered panel. SPAN Panel provides whole-home and per-circuit power/energy metering, remote relay control, whole-home backup coordination with solar and energy storage, and EV charging integration via SPAN Drive. As of the SPAN Panel firmware r202603 release (Q1 2026), SPAN exposes a public-beta on-premise SPAN API for software integrations between SPAN Panel and other devices on the home LAN.
URL: Visit APIs.json
Run: Capabilities Using Naftiko
- Energy, Home Energy, Electrification, Smart Panel, Electrical Panel, Home Automation, Solar, Energy Storage, EV Charging, Grid, Islanding, Backup Power, Demand Response, IoT, MQTT, Homie, Electrification Bus, On-Premise
- Created: 2026-05-25
- Modified: 2026-05-25
Local on-premise HTTP/JSON REST API hosted directly on SPAN Panel. Authentication is HTTP Bearer JWT minted by the panel via POST /api/v1/auth/register and bound to a named API client. The surface exposes system status, Wi-Fi scan/connect, panel state, main meter, panel power, islanding state, per-circuit control, panel grid relay, emergency reconnect, and energy storage state-of-energy and nice-to-have thresholds.
Human URL: https://github.com/spanio/SPAN-API-Client-Docs
Base URL: http://span-{serial-number}.local/api/v1
- OpenAPI
- Documentation — SPAN-API-Client-Docs
- Documentation — Public Beta announcement
- JSON Schema — mDNS Services
- JSON-LD Context
- Naftiko Capability — Circuits
- Naftiko Capability — Panel
- Naftiko Capability — Storage
- Naftiko Capability — Auth
- Naftiko Capability — Wi-Fi
Publish/subscribe streaming API hosted on SPAN Panel using the Electrification Bus (eBus) framework and the Homie Convention. SPAN Panel hosts an MQTT broker available over MQTTS (port 8883), WS, and WSS. Clients subscribe to ebus/5/<serial>/... topics for real-time panel state, per-circuit telemetry, energy storage state, and SPAN Drive integration data; clients publish to Homie /set topics to operate relays. Broker ACLs grant full read on ebus/#, write access only to /set and to non-panel device subtrees.
Human URL: https://github.com/spanio/SPAN-API-Client-Docs#span-api-interaction-models
- Portal — span.io
- Documentation — SPAN-API-Client-Docs
- Documentation — opensource.span.io
- AnnouncementPost — Introducing SPAN API and SPAN Home On-premise
- Product — SPAN Panel
- Product — SPAN Panel MAIN 32
- Product — SPAN Drive
- Product — SPAN Home App
- Product — SPAN Utilities (DERMS)
- GitHubOrganization — spanio
- Repository — SPAN-API-Client-Docs
- Forum — GitHub Discussions
- Issues — GitHub Issues
- ChangeLog
- License — MIT-0 (docs and example code)
- Support — support.span.io
- TermsOfService
- PrivacyPolicy
- SDK — span-panel-api (Python, community)
- SDK — Home Assistant Integration (community)
- SDK — SPAN Panel eBus Simulator (community)
- Tool — Reference scripts
- YouTube
FN: Kin Lane
Email: kin@apievangelist.com