State And Settings

An energy site is a home installation of batteries or solar panels (formerly from SolarCity, which was acquired by Tesla).

Work In Progress

Site Data

GET https://owner-api.teslamotors.com/api/1/energy_sites/:site_id/live_status

Shows a real-time view of the power output of the site. The Tesla Android app polls this method every 3 seconds to show the kW output.

Path Parameters

Name	Type	Description
:site_id	integer	The {energy_site_id} number from the products list

Headers

Name	Type	Description
Authorization	string	Bearer {access_token} from authentication

200 The solar_power value is the number of kilowatts (kW) currently being generated. Sometimes, the grid_status and grid_services_active fields are missing from the response object.

{
	"response": {
		"solar_power": 0,
		"grid_status": "Unknown",
		"grid_services_active": false,
		"timestamp": "2019-12-23T16:01:11-05:00"
	}
}

Site Configuration

GET https://owner-api.teslamotors.com/api/1/energy_sites/:site_id/site_info

Get installation and configuration details about the site. The site_name field value can be changed using the Site Name command.

Path Parameters

Name	Type	Description
:site_id	integer	The {energy_site_id} number from the products list

Headers

Name	Type	Description
Authorization	string	Bearer {access_token} from authentication

200 This installation has solar panels only and is located in the America/New_York time zone. If the site does not have a name set (using the Site Name command), the site_name field will be missing from the response object.

{
  "response": {
    "id": "00000000-0000-0000-0000-000000000000",
    "site_name": "My Site",
    "installation_date": "2017-01-01T00:00:00-05:00",
    "user_settings": {
      "storm_mode_enabled": null,
      "sync_grid_alert_enabled": false,
      "breaker_alert_enabled": false
    },
    "components": {
      "solar": true,
      "battery": false,
      "grid": true,
      "backup": false,
      "gateway": "neo",
      "load_meter": false,
      "tou_capable": false,
      "storm_mode_capable": false,
      "flex_energy_request_capable": false,
      "car_charging_data_supported": false,
      "configurable": false,
      "grid_services_enabled": false
    },
    "time_zone_offset": -300
  }
}

Historical Calendar Data

GET https://owner-api.teslamotors.com/api/1/energy_sites/:site_id/calendar_history

Generate a report for solar, grid, and battery data up to a given date, aligned with the start of various calendar periods. Reports for certain periods will return subtotals for smaller constituent periods. This method is used to render bar and line graphs in the Tesla Android app.

Path Parameters

Name	Type	Description
:site_id	integer	The {energy_site_id} number from the products list

Query Parameters

Name	Type	Description
end_date	string	ISO 8601 datetime, e.g. 2019-12-23T17:39:18.546Z. The response report interval ends on this datetime and starts at the beginning of the given period at 1:00 AM. Defaults to the current time.
time_zone	string	IANA/Olsen time zone identifier, e.g. America/New_York. Seems to have no effect on response data.
period	string	Amount of time to include in report. One of day, week, month, year, and lifetime. When kind is power, this parameter is ignored, is not required, and is always treated as day.
kind	string	Type of report to generate. One of power, energy, and self_consumption.

Headers

Name	Type	Description
Authorization	string	Bearer {access_token} from authentication

200 time_series The time_series array will contain objects with subtotals for one or more smaller periods inside the specified period. energy A request for a month will return a time series of objects with subtotals for each day (starting at 1 AM), year will return the same but with month subtotals, week will return days, lifetime will return years, and day will return a single object. The returned energy values are in watt-hours (Wh). power The time series will always be in 15 minute increments (hour aligned) starting at 12:00 AM on the given end_date, or the current date if end_date is missing, inclusive. The time series will finish at 11:45 PM on given day or at the last 15 minute increment before the current time, whichever is earlier, inclusive. The period parameter is ignored when kind=power, so you cannot get a 15 minute time series over an entire month with a single request, for example. The power values are in watts (W). Note that if you want to sum this time series to get watt-hours, you will need to divide the sum by 4, since the power is reported every 15 minutes, not every hour. time_zone_offset Number of minutes that the installation and this response report are ahead of UTC. The comments in the JSON snippets below are not part of the actual HTTP responses.

Energy for a day

/*
 * Between 1:00 AM and 12:39 PM on December 23, 2019, 
 * the solar panels generated 3.61 kWh of energy.
 *
 * ?kind=energy&period=day&time_zone=America%2FNew_York&end_date=2019-12-23T17%3A39%3A18.546Z
 */
   
{  
  "response": {
    "serial_number": "00000000-0000-0000-0000-000000000000",
    "period": "day",
    "time_zone_offset": -300,
    "time_series": [
      {
        "timestamp": "2019-12-23T01:00:00-05:00",
        "solar_energy_exported": 3610.0000000000005,
        "grid_energy_imported": 0,
        "grid_services_energy_imported": 0,
        "grid_services_energy_exported": 0,
        "grid_energy_exported_from_solar": 0,
        "grid_energy_exported_from_battery": 0,
        "battery_energy_exported": 0,
        "battery_energy_imported_from_grid": 0,
        "battery_energy_imported_from_solar": 0,
        "consumer_energy_imported_from_grid": 0,
        "consumer_energy_imported_from_solar": 0,
        "consumer_energy_imported_from_battery": 0
      }
    ]
  }
}

Energy for a month

/*
 * For month reports, the time series includes subtotals for each 
 * day between the first day of the month and the given end date 
 * (or the current time if end_date is missing), inclusive.
 *
 * ?kind=energy&period=month&time_zone=America%2FNew_York&end_date=2019-12-04T00%3A00%3A00.000-05%3A00
 */

{
  "response": {
    "serial_number": "00000000-0000-0000-0000-000000000000",
    "period": "month",
    "time_zone_offset": -300,
    "time_series": [{
      "timestamp": "2019-12-01T01:00:00-05:00",
      "solar_energy_exported": 1470,
      "grid_energy_imported": 0,
      "grid_services_energy_imported": 0,
      "grid_services_energy_exported": 0,
      "grid_energy_exported_from_solar": 0,
      "grid_energy_exported_from_battery": 0,
      "battery_energy_exported": 0,
      "battery_energy_imported_from_grid": 0,
      "battery_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_grid": 0,
      "consumer_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_battery": 0
    }, {
      "timestamp": "2019-12-02T01:00:00-05:00",
      "solar_energy_exported": 0,
      "grid_energy_imported": 0,
      "grid_services_energy_imported": 0,
      "grid_services_energy_exported": 0,
      "grid_energy_exported_from_solar": 0,
      "grid_energy_exported_from_battery": 0,
      "battery_energy_exported": 0,
      "battery_energy_imported_from_grid": 0,
      "battery_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_grid": 0,
      "consumer_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_battery": 0
    }, {
      "timestamp": "2019-12-03T01:00:00-05:00",
      "solar_energy_exported": 0,
      "grid_energy_imported": 0,
      "grid_services_energy_imported": 0,
      "grid_services_energy_exported": 0,
      "grid_energy_exported_from_solar": 0,
      "grid_energy_exported_from_battery": 0,
      "battery_energy_exported": 0,
      "battery_energy_imported_from_grid": 0,
      "battery_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_grid": 0,
      "consumer_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_battery": 0
    }, {
      "timestamp": "2019-12-04T00:00:00-05:00",
      "solar_energy_exported": 0,
      "grid_energy_imported": 0,
      "grid_services_energy_imported": 0,
      "grid_services_energy_exported": 0,
      "grid_energy_exported_from_solar": 0,
      "grid_energy_exported_from_battery": 0,
      "battery_energy_exported": 0,
      "battery_energy_imported_from_grid": 0,
      "battery_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_grid": 0,
      "consumer_energy_imported_from_solar": 0,
      "consumer_energy_imported_from_battery": 0
    }]
  }
}

Power for a day

/*
 * When kind=power, the time_series always starts at midnight on 
 * the given end_date, and proceeds in 15 minute increments. It 
 * stops before the end_date or, if the end_date is in the future,
 * before the current time.
 *
 * ?kind=power&period=day&end_date=2019-12-21T01%3A25%3A00.000-05%3A00&time_zone=America%2FNew_York
 */

{
  "response": {
    "serial_number": "00000000-0000-0000-0000-000000000000",
    "time_zone_offset": -300,
    "time_series": [{
      "timestamp": "2019-12-21T00:00:00-05:00",
      "solar_power": 0,
      "battery_power": 0,
      "grid_power": 0,
      "grid_services_power": 0
    }, {
      "timestamp": "2019-12-21T00:15:00-05:00",
      "solar_power": 0,
      "battery_power": 0,
      "grid_power": 0,
      "grid_services_power": 0
    }, {
      "timestamp": "2019-12-21T00:30:00-05:00",
      "solar_power": 0,
      "battery_power": 0,
      "grid_power": 0,
      "grid_services_power": 0
    }, {
      "timestamp": "2019-12-21T00:45:00-05:00",
      "solar_power": 0,
      "battery_power": 0,
      "grid_power": 0,
      "grid_services_power": 0
    }, {
      "timestamp": "2019-12-21T01:00:00-05:00",
      "solar_power": 0,
      "battery_power": 0,
      "grid_power": 0,
      "grid_services_power": 0
    }, {
      "timestamp": "2019-12-21T01:15:00-05:00",
      "solar_power": 0,
      "battery_power": 0,
      "grid_power": 0,
      "grid_services_power": 0
    }
  ]
}

Historical Data

GET https://owner-api.teslamotors.com/api/1/energy_sites/:site_id/history

May be a deprecated method. Seems to be similar to the Historical Calendar Data method above, except these responses are missing the time_zone_offset field.

Path Parameters

Name	Type	Description
:site_id	integer	The {energy_site_id} number from the products list

Headers

Name	Type	Description
Authorization	string	Bearer {access_token} from authentication

200

Site Summary

GET https://owner-api.teslamotors.com/api/1/energy_sites/:site_id/status

Warning: This method seems to always return 404 Not Found. It may have been removed from the API.

Path Parameters

Name	Type	Description
:site_id	integer	The {energy_site_id} number from the products list

Headers

Name	Type	Description
Authorization	string	Bearer {access_token} from authentication

404

<!DOCTYPE html>
<html>
<head>
  <title>The page you were looking for doesn't exist (404)</title>
  <style type="text/css">
    body { background-color: #fff; color: #666; text-align: center; font-family: arial, sans-serif; }
    div.dialog {
      width: 25em;
      padding: 0 4em;
      margin: 4em auto 0 auto;
      border: 1px solid #ccc;
      border-right-color: #999;
      border-bottom-color: #999;
    }
    h1 { font-size: 100%; color: #f00; line-height: 1.5em; }
  </style>
</head>

<body>
  <!-- This file lives in public/404.html -->
  <div class="dialog">
    <h1>The page you were looking for doesn't exist.</h1>
    <p>You may have mistyped the address or the page may have moved.</p>
  </div>
</body>
</html>