canonical: https://jentic.com/apis/netzeroenergy.com/netzeroenergy

# Netzeroenergy NetZero Tesla Energy API

The NetZero Tesla Energy API offers programmatic access to Tesla home energy site configuration and live telemetry through NetZero's broker platform. Developers can read live solar generation, battery percentage, and grid import or export data for a Tesla site, and update Powerwall operating mode and reserve percentage. Bearer tokens are issued through the NetZero app once a Tesla account is linked, and each call is scoped to a specific siteId.

## For AI agents

Read Tesla site live status and update Powerwall operating mode and reserve percentage for a NetZero-linked energy site.

## Scope

Does not handle Tesla vehicles, charging, or installation provisioning - use for Tesla site configuration and live status only.

## Capabilities

- Retrieve live Tesla site status combining solar power, battery percentage, and grid flow into one response
- Update Powerwall operating mode and reserve percentage by posting a new configuration for the site
- Authenticate every call with a bearer token issued from the NetZero app account settings
- Address a specific Tesla energy site using its siteId path parameter
- Inspect existing site configuration before applying changes to avoid unintended overwrites

## Use cases

### Tesla Site Live Telemetry Stream

Energy monitoring services poll GET /{siteId}/config to feed real-time solar production, Powerwall state of charge, and grid flow into time-series dashboards. The API returns a single combined payload, removing the need to call separate endpoints for configuration versus telemetry.

Example prompt: Schedule a poll of GET /{siteId}/config every 30 seconds, parse solar_power, battery_percentage, and grid_power, and write each sample to an InfluxDB bucket.

### Programmatic Powerwall Mode Switching

Home automation routines flip the Powerwall between self-consumption, backup-only, and time-based control modes by calling POST /{siteId}/config with a new configuration body. This enables tariff-aware battery dispatch without users opening the Tesla app.

Example prompt: POST to /{siteId}/config with operating_mode 'backup' at 17:00 weekdays and 'self_consumption' at 22:00 to align with peak tariff windows.

### Multi-Site Fleet Reporting

Solar installers managing multiple Tesla customer sites iterate over their list of siteIds and call GET /{siteId}/config for each, building a daily report of battery health and grid contribution across the fleet. The single-site scoping of the API makes per-customer rollups straightforward.

Example prompt: For each siteId in the installer's customer list, call GET /{siteId}/config, collect battery_percentage, and email a daily summary report listing sites below 20%.

### AI Agent Energy Concierge

A homeowner-facing agent uses Jentic to discover NetZero Tesla Energy operations, then handles requests like 'put the Powerwall in backup mode tonight' by translating the natural language request into a POST to /{siteId}/config without the user touching code or the Tesla app.

Example prompt: Use Jentic to search 'set tesla powerwall to backup mode', load POST /{siteId}/config, and execute it with operating_mode 'backup' and the user's siteId.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/{siteId}/config` | Get site configuration and live status |
| POST | `/{siteId}/config` | Modify site configuration |

## Key resources

- **Configuration** — Read live status and update operating mode and reserve percentage for a Tesla site

## Why Jentic

- **Setup:** Wiring the NetZero Tesla Energy API by hand means setting its bearer auth, targeting the api.netzero.energy/api/v1 host, and shaping Tesla site config read and write calls yourself. Through Jentic you install once, import NetZero Tesla Energy from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** NetZero Tesla Energy puts the site id in the URL path (/{siteId}/config), so a rule can pin your agent to one site. You choose the operations it may call, so the config write that changes the reserve is not included unless you add it.
- **Credential handling:** Your NetZero bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'set a Tesla Powerwall reserve' or 'read a site config', and Jentic returns the matching NetZero Tesla Energy operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Tesla Fleet API** — Tesla's first-party Fleet API for energy sites and vehicles
- **Netzero Energy API** — Sister specification under the netzero.energy domain
- **OpenAI API** — Summarise live Tesla telemetry into natural-language updates

## FAQ

### What authentication does the NetZero Tesla Energy API use?

The API uses HTTP bearer token authentication via the Authorization header. Tokens are minted inside the NetZero app once a Tesla account is linked. Through Jentic, the bearer token is stored in your Jentic One instance and injected at request time so it never appears in the agent's context.

### Can I update Powerwall operating mode with the NetZero Tesla Energy API?

Yes. POST /{siteId}/config accepts a configuration body containing operating_mode and reserve_percentage. The change is applied to the Tesla site identified by siteId immediately after the call returns successfully.

### How do I get live solar and battery data through Jentic?

Search Jentic for 'get tesla site live status', load the GET /{siteId}/config schema, and execute the call with the user's siteId. The response contains both the static configuration and live telemetry fields in one payload.

### What are the rate limits for the NetZero Tesla Energy API?

The spec does not publish explicit numeric rate limits. NetZero brokers calls to Tesla, so polling more than once every 15-30 seconds per site risks being throttled upstream - design for sustained low-frequency polling.

### How does this API differ from the Tesla Fleet API?

NetZero Tesla Energy is a third-party simplification covering only site configuration and live status with two endpoints. The Tesla Fleet API requires partner approval but covers vehicles, charging, and the full energy product surface.

### Is the NetZero Tesla Energy API free?

Access is bundled with a NetZero account that has a Tesla site linked. There is no separate API tier - the bearer token grants access to the same site the user already manages in the NetZero app.

### Can I limit what my agent is allowed to do with the NetZero Tesla Energy API?

Yes. Because you self-host Jentic One, your own rules decide which of the two operations the agent may call, so you can grant read-only access to GET /{siteId}/config for live solar, battery, and grid data while withholding the POST /{siteId}/config write that changes operating mode and reserve percentage. Since the site is addressed by its siteId in the URL path, you can also pin the agent to a single Tesla site. The bearer token is stored once by your Jentic One instance and injected at request time, so the agent only ever exercises the operations you allow.