# SPAN eBus MQTT API

**Canonical:** https://apis.io/apis/span-io/span-ebus-mqtt-api/  
**Provider:** SPAN — https://apis.io/providers/span-io/  
**Documentation:** https://github.com/spanio/SPAN-API-Client-Docs#span-api-interaction-models

SPAN eBus MQTT API is one of 9 APIs that [SPAN](https://apis.io/providers/span-io/) publishes on the [APIs.io](https://apis.io/) network, described by an AsyncAPI event-driven specification. This API exposes 1 JSON Schema definition. Tagged areas include MQTT, Homie, Electrification Bus, eBus, and Pub-Sub. The published artifact set on APIs.io includes API documentation, an AsyncAPI specification, and 1 JSON Schema.

Publish/subscribe streaming API hosted on SPAN Panel using the Electrification Bus (eBus) integration framework and the Homie Convention. SPAN Panel hosts an MQTT broker accessible over MQTTS (8883), WS, and WSS. Clients subscribe to `ebus/5/<serial>/...` topics to receive real-time panel state, per-circuit telemetry, energy storage state, and SPAN Drive integration data, and publish to `/set` topics to operate relays and control panel state. The broker enforces topic-level ACLs — full read access on `ebus/#`, write access limited to Homie `/set` control topics and to non-panel device subtrees under `ebus/5/`. Credentials are obtained via the REST authentication endpoint.

## Machine-readable artifacts (6)

- **Documentation** — https://github.com/spanio/SPAN-API-Client-Docs#publishsubscribe
- **Documentation** — https://homieiot.github.io/specification/
- **Documentation** — https://ebus.energy/
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/span-io/refs/heads/main/asyncapi/span-ebus-asyncapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/span-io/refs/heads/main/json-schema/span-homie-schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/span-io/refs/heads/main/apis.yml

## Other SPAN APIs (8)

- [SPAN Auth API](https://apis.io/apis/span-io/span-io-auth-api/)
- [SPAN Circuits API](https://apis.io/apis/span-io/span-io-circuits-api/)
- [SPAN Islanding State API](https://apis.io/apis/span-io/span-io-islanding-state-api/)
- [SPAN Panel API](https://apis.io/apis/span-io/span-io-panel-api/)
- [SPAN Spaces API](https://apis.io/apis/span-io/span-io-spaces-api/)
- [SPAN Status API](https://apis.io/apis/span-io/span-io-status-api/)
- [SPAN Storage API](https://apis.io/apis/span-io/span-io-storage-api/)
- [SPAN Wifi API](https://apis.io/apis/span-io/span-io-wifi-api/)

## Tags

MQTT, Homie, Electrification Bus, eBus, Pub-Sub, Streaming, On-Premise, Energy

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/span-io/span-ebus-mqtt-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/span-io/.