Tesla Energy · Schema

Tesla Energy Site

Static configuration of a Tesla energy site returned by GET /energy_sites/{site_id}/site_info. An energy site is a customer-installed system that may include Powerwall (residential battery), Megapack (utility battery), Tesla Solar Inverter, retrofit solar panels, or Solar Roof.

EnergyClean EnergySolarBattery StoragePowerwallMegapackSolar RoofVirtual Power PlantIoTGrid ServicesHome EnergyUtility Scale

Properties

Name	Type	Description
id	string	Energy site identifier (UUID-style string).
site_name	string	Human-readable name the owner gave the site.
backup_reserve_percent	integer	Reserve percent held back for grid outages.
default_real_mode	string	Current operation mode of the site.
installation_date	string
installation_time_zone	string	IANA time zone identifier.
version	string	Gateway firmware version.
battery_count	integer	Number of Powerwall (or Megapack) units installed.
nameplate_power	number	Nameplate continuous power rating in watts.
nameplate_energy	number	Nameplate energy capacity in watt-hours.
components	object
address	object
user_settings	object

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tesla-energy/refs/heads/main/json-schema/tesla-energy-site-schema.json",
  "title": "Tesla Energy Site",
  "description": "Static configuration of a Tesla energy site returned by GET /energy_sites/{site_id}/site_info. An energy site is a customer-installed system that may include Powerwall (residential battery), Megapack (utility battery), Tesla Solar Inverter, retrofit solar panels, or Solar Roof.",
  "type": "object",
  "required": ["id", "site_name"],
  "properties": {
    "id": {
      "type": "string",
      "description": "Energy site identifier (UUID-style string)."
    },
    "site_name": {
      "type": "string",
      "description": "Human-readable name the owner gave the site."
    },
    "backup_reserve_percent": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "description": "Reserve percent held back for grid outages."
    },
    "default_real_mode": {
      "type": "string",
      "enum": ["self_consumption", "backup", "autonomous"],
      "description": "Current operation mode of the site."
    },
    "installation_date": {
      "type": "string",
      "format": "date-time"
    },
    "installation_time_zone": {
      "type": "string",
      "description": "IANA time zone identifier."
    },
    "version": {
      "type": "string",
      "description": "Gateway firmware version."
    },
    "battery_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of Powerwall (or Megapack) units installed."
    },
    "nameplate_power": {
      "type": "number",
      "description": "Nameplate continuous power rating in watts."
    },
    "nameplate_energy": {
      "type": "number",
      "description": "Nameplate energy capacity in watt-hours."
    },
    "components": {
      "type": "object",
      "properties": {
        "battery": {"type": "boolean"},
        "solar": {"type": "boolean"},
        "solar_type": {"type": "string"},
        "grid": {"type": "boolean"},
        "grid_services": {"type": "boolean"},
        "storm_mode_capable": {"type": "boolean"},
        "backup_time_remaining_enabled": {"type": "boolean"},
        "off_grid_vehicle_charging_reserve_supported": {"type": "boolean"}
      }
    },
    "address": {
      "type": "object",
      "properties": {
        "address": {"type": "string"},
        "city": {"type": "string"},
        "state": {"type": "string"},
        "zip": {"type": "string"},
        "country": {"type": "string"}
      }
    },
    "user_settings": {
      "type": "object",
      "properties": {
        "storm_mode_enabled": {"type": "boolean"},
        "powerwall_onboarding_settings_set": {"type": "boolean"},
        "sync_grid_alert_enabled": {"type": "boolean"},
        "breaker_alert_enabled": {"type": "boolean"}
      }
    }
  }
}