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
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  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