--- title: "Site Level Live Status" method: GET path: "/api/v4/systems/{system_id}/live_data" tags: ["Streaming APIs"] --- # Site Level Live Status `GET /api/v4/systems/{system_id}/live_data` ## Request - Base URL: `https://api-qa2.enphaseenergy.com` - URL: `https://api-qa2.enphaseenergy.com/api/v4/systems/{system_id}/live_data` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) API users can get real-time live status data on demand for a given system. Users can retrieve real-time power values for PV Production, Grid Import/Export, Consumption, Battery Charge/Discharge, Generator, and EVSE. The API supports multi-Envoy aggregation, summing power values across multiple gateways and applying intelligent field resolution for Battery State of Charge (SOC), Battery Mode, and Grid Status. EVSE data supports multiple chargers, returning charger serial numbers as a list and aggregating consumption power across all active chargers. The live status stream is provided for 30 seconds by default and can be configured using the duration parameter (minimum 30 seconds, maximum 300 seconds). ## Path parameters - `system_id` integer, required ## Headers - `duration` integer ## Response `200` successful operation ## Other responses - `401`: User will get 401 in the below cases. Response content type is application/json NOT_AUTHENTICATED - API key is missing UNAUTHORIZED - Access token is invalid UNAUTHORIZED - Access token has expired NOT_AUTHENTICATED - API Key is invalid UNAUTHORIZED - Application is not authorized to access the requested resource - `403`: User is not authorized. Response content type is application/json - `429`: Too Many Requests. Response content type is application/json - `461`: Duration is less than 30 seconds. Response content type is application/json - `462`: Duration is greater than 300 seconds. Response content type is application/json - `463`: Duration is not integer. Response content type is application/json - `466`: Envoy must be active and envoy version must be at least 6.0.0. Response content type is application/json - `468`: System ID does not exist. Response content type is application/json - `472`: For Ensemble sites, live stream will be supported in the following cases - If site has an active battery or active system controller, then site must have active production meter and active consumption meter; Otherwise, site must have active production meter. Response content type is application/json - `473`: IQ gateway is not reporting. Response content type is application/json - `474`: EV charger issue. Response content type is application/json - `550`: Service unreachable. Response content type is application/json - `551`: Service unreachable. Response content type is application/json - `552`: Unable to connect. Response content type is application/json --- [API](https://skmtc.dev/enphase/apis/monitoring-api.md) - [All operations](https://skmtc.dev/enphase/apis/monitoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enphase/apis/monitoring-api/revisions/a783ff728669?raw)