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 API contracts indexed 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 30 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Energy & Utilities regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/tesla-energy/"><img src="https://apis.io/badge/tesla-energy/card.svg" alt="Tesla Energy on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
Not yet checked against Tesla Energy's own pricing page. Compiled by API Evangelist on 2026-05-25 from www.tesla.com/powerwall; confirm before you rely on a figure. A free plan or tier is listed.
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.
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
gated: none
gated_source:
- onboarding
label: Freemium · Self-serve signup
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-06'
method: derived
image: ''
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.23'
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:
- Product
tags_raw:
- 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
tags_raw:
- 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: CapabilityMap
url: capabilities/tesla-energy-capability-edges.yml
name: Tesla Energy Business Capability Map
- 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
x-parent: tesla
x-relationship: division
Tesla Energy API — frequently asked questions
Does Tesla Energy have an API?
Yes. APIs.io lists 10 APIs from Tesla Energy, including Tesla Energy Backup API, Tesla Energy History API and Tesla Energy Live Status API, and 7 more.
Is there an OpenAPI specification for the Tesla Energy API?
Yes. APIs.io indexes 10 OpenAPI specifications for Tesla Energy, each linked for download from this page.
How do I authenticate with the Tesla Energy API?
Tesla Energy documents its authentication (oauth2 · 1 scheme). The details are profiled on APIs.io as Tesla Energy Authentication.
How much does the Tesla Energy API cost?
APIs.io lists 5 pricing plans for Tesla Energy, with each plan's price, limits and inclusions under Pricing on this page.
Is the Tesla Energy API ready for AI agents?
Tesla Energy has a Kin Score of 49.0 out of 100 (developing) and an Agent Readiness score of 26.1 (agent-aware), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: