Home
Providers
Tesla Energy
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.
10 APIs
19 Features
Energy Clean Energy Solar Battery Storage Powerwall Megapack Solar Roof Virtual Power Plant IoT Grid Services Home Energy Utility Scale
On this page
Kin Score
APIs 10
Postman 10
Open Collections 1
Pricing Plans 1
Rate Limits 1
FinOps 1
Features 19
Vocabularies 1
Spectral Rules 2
JSON Schema 2
Examples 2
Security Posture 2
Scopes 1
Agentic Access 1
Resources 35
apis.yml
53 Operational Transparency
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
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
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 10
Ready-to-run Postman collections for exercising this provider's APIs.
Scroll for all 10
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
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
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
Example request and response payloads for these APIs.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
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)
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