Tesla Energy

Tesla Energy is Tesla's solar generation and battery storage business unit, encompassing residential Powerwall, utility-scale Megapack, retrofit solar panels, and the Solar Roof. The Fleet API exposes energy_sites endpoints that let partners and owners read live power, calendar history, and site info, and write backup reserve, operation mode (self_consumption, backup, autonomous), storm mode, time-of-use settings, and off-grid vehicle charging reserve — the same control surface that powers the Tesla app and integrators like Autobidder, Tesla Electric (virtual power plant), and third-party home energy dashboards.

Tesla Energy publishes 10 APIs on the APIs.io network, including Backup API, History API, Live Status API, and 7 more. Tagged areas include Energy, Clean Energy, Solar, Battery Storage, and Powerwall.

The Tesla Energy catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Tesla Energy’s developer surface includes authentication, developer portal, documentation, changelog, FAQ, support, and 29 more developer resources.

62.7/100 strong ▼ -5.2 Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
10 APIs 19 Features
EnergyClean EnergySolarBattery StoragePowerwallMegapackSolar RoofVirtual Power PlantIoTGrid ServicesHome EnergyUtility Scale

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 62.7/100 · strong
Contract Quality 19.9 / 25
Developer Ergonomics 10.4 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 6.8 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/tesla-energy: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 10

Individual APIs this provider publishes, each with its own machine-readable definition.

Tesla Energy Backup API

Backup reserve threshold for Powerwall sites

Tesla Energy History API

Historical energy production, consumption, and battery flow

Tesla Energy Live Status API

Real-time power, state-of-charge, and grid status for an energy site

Tesla Energy Off Grid Charging API

Reserve threshold for EV charging when the site is islanded from the grid

Tesla Energy Operation API

Operation mode — self_consumption, backup, or autonomous

Tesla Energy Products API

Discover energy_sites and other products owned by the authenticated account

Tesla Energy Programs API

Virtual power plant and grid-services program participation

Tesla Energy Site Info API

Static configuration of an energy site (components, address, time zone)

Tesla Energy Storm Mode API

Pre-charge Powerwall to 100% ahead of severe weather alerts

Tesla Energy Time Of Use API

Tariff schedule, peak/off-peak rate plans, and TOU optimization

Scroll for all 10

Postman Collections 10

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 10

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Tesla Fleet Energy API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Tesla Energy Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 19

Notable capabilities this provider offers.

Powerwall residential battery — 13.5 kWh per unit, stackable up to 10 units, with integrated inverter and gateway in Powerwall+
Megapack utility-scale battery — up to 3.9 MWh per unit, containerized DC architecture for grid storage and frequency regulation
Solar Roof — integrated solar shingles for new and retrofit residential roofs
Retrofit solar panels — private-label panels paired with Tesla Solar Inverter (cellular-connected, OTA updates)
Autobidder — real-time energy trading and dispatch platform for utility-scale storage
Tesla Electric — virtual utility / retail electricity provider in Texas with Powerwall participation
Fleet API energy_sites endpoints for partner read/write access to site state and operation
Backup reserve control — set the % state-of-charge Powerwall holds in reserve for outages
Operation mode control — self_consumption, backup-only, autonomous (algorithmic)
Storm Mode — automatically charges Powerwall to 100% ahead of severe weather alerts
Time-of-Use settings — tariff schedule and peak/off-peak rate plan management
Off-Grid Vehicle Charging Reserve — separate reserve threshold for EV charging during outages
Calendar history — historical energy production, consumption, grid import/export, battery flow
Live Status — real-time site power, state-of-charge, grid status, and load breakdown
Programs — virtual power plant and grid services participation status
Tesla app — single-pane control for Powerwall, Solar, and vehicles (consumer surface above the API)
Lathrop, CA Megapack factory (operational since 2022) — 40 GWh/year capacity
Shanghai Megafactory — Tesla's second Megapack factory, online 2025
Energy revenue $10.1B in 2024 (+67% YoY); 31.4 GWh battery deployments in 2023 (+113% YoY)

Scroll for all 19

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Tesla Energy Context

11 classes · 25 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Tesla Energy API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Tesla Energy API Rules

8 rules · 2 errors 6 warnings

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Tesla Energy Site Live Status

13 properties

JSON SCHEMA

Tesla Energy Site

13 properties

JSON SCHEMA

Examples 2

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Tesla Energy Authentication

oauth2 · 1 scheme

SECURITY

Tesla Energy Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Tesla Energy Scopes

3 scopes · authorizationCode

3 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Tesla Energy Agentic Access

10 operations · 5 acting

10 operations · 5 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 3

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 6

SDKs, sample code, and the tooling you integrate with

Access & Security 5

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 8

The organization behind the API

Scroll for all 8

Source (apis.yml)

apis.yml Raw ↑
aid: tesla-energy
url: https://raw.githubusercontent.com/api-evangelist/tesla-energy/refs/heads/main/apis.yml
name: Tesla Energy
description: Tesla Energy is Tesla's solar generation and battery storage business unit, encompassing residential Powerwall,
  utility-scale Megapack, retrofit solar panels, and the Solar Roof. The Fleet API exposes energy_sites endpoints that let
  partners and owners read live power, calendar history, and site info, and write backup reserve, operation mode (self_consumption,
  backup, autonomous), storm mode, time-of-use settings, and off-grid vehicle charging reserve — the same control surface
  that powers the Tesla app and integrators like Autobidder, Tesla Electric (virtual power plant), and third-party home energy
  dashboards.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://www.tesla.com/favicon.ico
tags:
- Energy
- Clean Energy
- Solar
- Battery Storage
- Powerwall
- Megapack
- Solar Roof
- Virtual Power Plant
- IoT
- Grid Services
- Home Energy
- Utility Scale
kind: contract
access: 3rd-Party
specificationVersion: '0.19'
created: '2026-05-25'
modified: '2026-05-25'
position: Producing
apis:
- aid: tesla-energy:tesla-energy-backup-api
  name: Tesla Energy Backup API
  description: Backup reserve threshold for Powerwall sites
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Backup
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-backup-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-history-api
  name: Tesla Energy History API
  description: Historical energy production, consumption, and battery flow
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - History
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-history-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-live-status-api
  name: Tesla Energy Live Status API
  description: Real-time power, state-of-charge, and grid status for an energy site
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Live Status
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-live-status-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-off-grid-charging-api
  name: Tesla Energy Off Grid Charging API
  description: Reserve threshold for EV charging when the site is islanded from the grid
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Off Grid Charging
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-off-grid-charging-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-operation-api
  name: Tesla Energy Operation API
  description: Operation mode — self_consumption, backup, or autonomous
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Operation
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-operation-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-products-api
  name: Tesla Energy Products API
  description: Discover energy_sites and other products owned by the authenticated account
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-products-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-programs-api
  name: Tesla Energy Programs API
  description: Virtual power plant and grid-services program participation
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Programs
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-programs-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-site-info-api
  name: Tesla Energy Site Info API
  description: Static configuration of an energy site (components, address, time zone)
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Site Info
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-site-info-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-storm-mode-api
  name: Tesla Energy Storm Mode API
  description: Pre-charge Powerwall to 100% ahead of severe weather alerts
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Storm Mode
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-storm-mode-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
- aid: tesla-energy:tesla-energy-time-of-use-api
  name: Tesla Energy Time Of Use API
  description: Tariff schedule, peak/off-peak rate plans, and TOU optimization
  humanURL: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  baseURL: https://fleet-api.prd.na.vn.cloud.tesla.com/api/1
  tags:
  - Time Of Use
  properties:
  - type: OpenAPI
    url: openapi/tesla-energy-time-of-use-api-openapi.yml
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - type: Authentication
    url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  - type: Documentation
    url: https://developer.tesla.com/docs/fleet-api/virtual-key/overview
  - type: JSONSchema
    url: json-schema/tesla-energy-site-schema.json
  - type: JSONSchema
    url: json-schema/tesla-energy-live-status-schema.json
  - type: JSONLD
    url: json-ld/tesla-energy-context.jsonld
  - type: Examples
    url: examples/tesla-energy-live-status-example.json
  - type: Examples
    url: examples/tesla-energy-site-info-example.json
  - type: SpectralRules
    url: rules/tesla-energy-rules.yml
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/tesla-energy/overview
- type: AgenticAccess
  url: agentic-access/tesla-energy-agentic-access.yml
- type: DomainSecurity
  url: security/tesla-energy-domain-security.yml
- type: Authentication
  url: authentication/tesla-energy-authentication.yml
- type: OAuthScopes
  url: scopes/tesla-energy-scopes.yml
- type: Portal
  url: https://www.tesla.com/energy
- type: Portal
  url: https://developer.tesla.com/
  name: Tesla Developer Portal
- type: Documentation
  url: https://developer.tesla.com/docs/fleet-api
  name: Tesla Fleet API
- type: Documentation
  url: https://developer.tesla.com/docs/fleet-api/endpoints/energy
  name: Energy Endpoints
- type: Documentation
  url: https://developer.tesla.com/docs/fleet-api/products/energy-products
  name: Energy Products
- type: Authentication
  url: https://developer.tesla.com/docs/fleet-api/authentication/overview
  name: Fleet API Authentication
- type: Authentication
  url: https://developer.tesla.com/docs/fleet-api/authentication/third-party-tokens
  name: Third-Party Tokens
- type: RateLimits
  url: https://developer.tesla.com/docs/fleet-api/billing-and-limits
  name: Fleet API Billing and Limits
- type: Billing
  url: https://developer.tesla.com/docs/fleet-api/billing-and-limits
  name: Fleet API Billing
- type: ChangeLog
  url: https://developer.tesla.com/docs/fleet-api/announcements
  name: Fleet API Announcements
- type: FAQ
  url: https://developer.tesla.com/docs/fleet-api/support/faq
  name: Fleet API FAQ
- type: Support
  url: https://developer.tesla.com/docs/fleet-api/support/contact
- type: GitHubOrganization
  url: https://github.com/teslamotors
- type: SDKs
  url: https://github.com/teslamotors/vehicle-command
  name: Tesla Vehicle Command SDK (Go) — Fleet API HTTP proxy
- type: SDKs
  url: https://github.com/tdorssers/TeslaPy
  name: TeslaPy (community Python SDK, energy_sites support)
- type: SDKs
  url: https://github.com/timdorr/tesla-api
  name: timdorr/tesla-api (community Owner API docs, includes energy)
- type: Postman
  url: https://documenter.getpostman.com/view/781424/2s9YRCWB4f
  name: Tesla Postman Collection
- type: Website
  url: https://www.tesla.com
- type: Website
  url: https://www.tesla.com/powerwall
  name: Powerwall
- type: Website
  url: https://www.tesla.com/megapack
  name: Megapack
- type: Website
  url: https://www.tesla.com/solarpanels
  name: Solar Panels
- type: Website
  url: https://www.tesla.com/solarroof
  name: Solar Roof
- type: Website
  url: https://www.tesla.com/electric
  name: Tesla Electric (virtual utility, Texas)
- type: Website
  url: https://www.tesla.com/autobidder
  name: Autobidder (energy trading platform)
- type: LinkedIn
  url: https://www.linkedin.com/company/tesla-motors
- type: TermsOfService
  url: https://www.tesla.com/legal
- type: PrivacyPolicy
  url: https://www.tesla.com/legal/privacy
- type: Plans
  url: plans/tesla-energy-plans-pricing.yml
- type: RateLimits
  url: rate-limits/tesla-energy-rate-limits.yml
- type: FinOps
  url: finops/tesla-energy-finops.yml
- type: Features
  data:
  - Powerwall residential battery — 13.5 kWh per unit, stackable up to 10 units, with integrated inverter and gateway in Powerwall+
  - Megapack utility-scale battery — up to 3.9 MWh per unit, containerized DC architecture for grid storage and frequency
    regulation
  - Solar Roof — integrated solar shingles for new and retrofit residential roofs
  - Retrofit solar panels — private-label panels paired with Tesla Solar Inverter (cellular-connected, OTA updates)
  - Autobidder — real-time energy trading and dispatch platform for utility-scale storage
  - Tesla Electric — virtual utility / retail electricity provider in Texas with Powerwall participation
  - Fleet API energy_sites endpoints for partner read/write access to site state and operation
  - Backup reserve control — set the % state-of-charge Powerwall holds in reserve for outages
  - Operation mode control — self_consumption, backup-only, autonomous (algorithmic)
  - Storm Mode — automatically charges Powerwall to 100% ahead of severe weather alerts
  - Time-of-Use settings — tariff schedule and peak/off-peak rate plan management
  - Off-Grid Vehicle Charging Reserve — separate reserve threshold for EV charging during outages
  - Calendar history — historical energy production, consumption, grid import/export, battery flow
  - Live Status — real-time site power, state-of-charge, grid status, and load breakdown
  - Programs — virtual power plant and grid services participation status
  - Tesla app — single-pane control for Powerwall, Solar, and vehicles (consumer surface above the API)
  - Lathrop, CA Megapack factory (operational since 2022) — 40 GWh/year capacity
  - Shanghai Megafactory — Tesla's second Megapack factory, online 2025
  - Energy revenue $10.1B in 2024 (+67% YoY); 31.4 GWh battery deployments in 2023 (+113% YoY)
  sources:
  - https://developer.tesla.com/docs/fleet-api/endpoints/energy
  - https://www.tesla.com/energy
  - https://www.tesla.com/powerwall
  - https://www.tesla.com/megapack
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com