Skip to content

Repository files navigation

Voltus (voltus)

Voltus is a United States virtual power plant (VPP) operator and distributed energy resource (DER) technology platform, headquartered in San Francisco, California, that aggregates commercial, industrial, residential and transportation loads and batteries into wholesale electricity markets across all of North America's organized markets (AESO, CAISO, ERCOT, IESO, ISO-NE, MISO, NYISO, PJM, SPP). It sits in the demand-response and flexibility layer of the energy value chain: it is not a utility and not a metering data holder, so no Green Button, Consumer Data Right or smart-meter data mandate applies to it — mandate regime is honestly none. Its API posture is unusually good for the sector and unusually split. Voltus runs a genuine public developer portal at api.voltus.co/docs (Docusaurus, no login) with concepts, tutorials, an OpenAPI-generated reference and a changelog, plus a fully anonymous sandbox at sandbox.voltus.co that answers real HTTP requests with the documented public key X-Voltus-API-Key: secret — a developer can call it before signing anything. Production, however, is partner-only: api.voltus.co/2022-04-15 returns 401 Permission denied to the sandbox key, and real access requires a commercial partnership plus a signed Letter of Authorization per site. Site telemetry and dispatch control are exposed to partners over that account-scoped REST API and over OpenADR 2.0a Simple HTTP PULL with mutual TLS; Voltus publishes no open grid or market data of its own, so consumer/site energy data is available under contract while market data is closed. No downloadable OpenAPI or Swagger document is served — /openapi.json, /swagger.json and /openapi3.yaml all 404.

APIs.json: https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/apis.yml

Tags

  • Energy
  • United States
  • Electricity
  • Demand Response
  • Virtual Power Plant
  • DER
  • Grid
  • Energy Markets
  • Flexibility
  • Energy Storage
  • OpenADR
  • Telemetry

Timestamps

  • Created: 2026-07-27
  • Modified: 2026-07-27

APIs

Voltus Dispatches API

Grid dispatch events for enrolled sites — list dispatches, retrieve a single dispatch by ID, and create a test dispatch. Documented operations are GET /dispatches, POST /dispatches and GET /dispatch. Dispatch objects carry program, market (e.g. MISO), program_type, start/end time, modification number and per-site drop_by and commitment values. Verified live against the public sandbox.

Tags

  • Demand Response
  • Dispatch
  • Energy Markets

Properties

Voltus Sites API

Read the sites (facilities) enrolled with Voltus under the calling account, with their meters. The single documented operation is GET /sites, returning site name, id and customer_location_id, with an asset_type field on each meter object added 2026-07-01. Verified live against the public sandbox.

Tags

  • Sites
  • Metering
  • DER

Properties

Voltus Telemetry API

Submit and retrieve interval energy telemetry for enrolled sites. Documented operations are POST /telemetry, POST /telemetry/controllable-load and GET /telemetry/kw (maximum 10 sites per request, maximum 90-day interval, 10,000 data points per site). This is the site-level customer energy-usage surface — account-scoped to the API key holder, not a Green Button or Consumer Data Right style consented third-party feed.

Tags

  • Telemetry
  • Metering
  • Electricity
  • Flexibility

Properties

Voltus Webhooks API

Register HTTP callbacks so Voltus can push dispatch notifications instead of the partner polling. Documented operations are GET /webhooks, POST /webhooks and DELETE /webhooks/{id}.

Tags

  • Webhooks
  • Dispatch
  • Notifications

Properties

Voltus OpenADR 2.0a VTN

Standards-based alternative to the REST dispatch integration. Voltus states it "supports OpenADR2.0a via Simple HTTP (PULL)" and that "Voltus provides a VTN, and our partners run one or more VENs". Partners poll https://openadr.voltus.co/vtn/YOUR_VEN_ID/OpenADR2/Simple/EiEvent (recommended once per minute) and reply with an oadrCreatedEvent acknowledgement. Authentication is mutual TLS — the partner submits a Certificate Signing Request to Voltus and presents the returned client certificate.

Tags

  • OpenADR
  • Demand Response
  • Standards
  • Dispatch

Properties

Common Properties

Maintainers

About

API Evangelist profile of voltus — energy and utilities organization APIs.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors