# Voltus

> Voltus is a United States virtual power plant (VPP) operator and distributed energy resource (DER) aggregator, headquartered in San Francisco, that turns commercial, industrial, residential and transportation load and batteries into wholesale capacity across all nine North American organized markets (AESO, CAISO, ERCOT, IESO, ISO-NE, MISO, NYISO, PJM, SPP). Its API lets a channel partner, OEM or DER owner receive grid dispatches, report interval telemetry, and control enrolled sites. Documentation and a working sandbox are fully public; production access requires a commercial partnership and a signed Letter of Authorization per site.

Generated by API Evangelist from the Voltus developer portal and the harvested contract. No /llms.txt is published by Voltus (api.voltus.co/llms.txt returns 404, /docs/llms.txt returns 500) - this file is our faithful reconstruction.

Base URL: https://api.voltus.co/2022-04-15 (date-versioned; api.voltus.co redirects to the latest version)
Sandbox:  https://sandbox.voltus.co with header "X-Voltus-API-Key: secret" (public, no account needed)
Auth:     API key in the X-Voltus-API-Key header, issued by a Voltus account manager. No OAuth, no scopes.
Errors:   application/json {"message": "...", "type": "<HTTP status phrase>"} - not RFC 9457.
Limits:   x-ratelimit-limit / -remaining / -reset headers; observed 301 production, 101 sandbox.

## APIs

- [Voltus Dispatches API](https://api.voltus.co/docs/openapi/dispatches): List dispatches, retrieve one by id, create a test dispatch. Dispatches carry program, market, start/end time, modification_number and a per-site commitment.
- [Voltus Sites API](https://api.voltus.co/docs/openapi/sites): List the sites enrolled under your account and their meters (asset_type: load, battery, generator, poi).
- [Voltus Telemetry API](https://api.voltus.co/docs/openapi/telemetry): Submit interval telemetry and controllable load; read back up to 10 sites x 90 days x 10,000 points per request.
- [Voltus Webhooks API](https://api.voltus.co/docs/openapi/webhooks): Register HTTPS callbacks for dispatch.create and dispatch.update instead of polling.
- [Voltus OpenADR 2.0a VTN](https://api.voltus.co/docs/concepts/openadr): Standards-based alternative. Voltus runs the VTN, partners run VENs, polling Simple HTTP PULL over mutual TLS.

## Operations

- voltus#get-sites - GET /2022-04-15/sites
- voltus#get-dispatches - GET /2022-04-15/dispatches
- voltus#get-dispatch - GET /2022-04-15/dispatches/{id}
- voltus#post-dispatch - POST /2022-04-15/dispatches (creates a test dispatch)
- voltus#get-telemetry-kw - GET /2022-04-15/telemetry/kw
- voltus#post-telemetry - POST /2022-04-15/telemetry
- voltus#post-controllable-load - POST /2022-04-15/telemetry/controllable-load
- voltus#get-webhooks - GET /2022-04-15/webhooks
- voltus#post-webhook - POST /2022-04-15/webhooks
- voltus#delete-webhook - DELETE /2022-04-15/webhooks/{id}

## Docs

- [Developer portal](https://api.voltus.co/docs/)
- [API reference](https://api.voltus.co/docs/openapi/voltus-api-reference)
- [First API request: get sites](https://api.voltus.co/docs/tutorials/first-api-request-get-sites)
- [Fetch and poll dispatches](https://api.voltus.co/docs/tutorials/get-sandbox-dispatches)
- [Create a dispatch integration](https://api.voltus.co/docs/tutorials/create-a-dispatch-integration)
- [Test your dispatch integration](https://api.voltus.co/docs/tutorials/test-your-dispatch-integration)
- [Get telemetry](https://api.voltus.co/docs/tutorials/get-telemetry)
- [Send telemetry](https://api.voltus.co/docs/tutorials/send-telemetry)
- [Set up an OpenADR integration](https://api.voltus.co/docs/tutorials/openadr)
- [Sandbox public credentials](https://api.voltus.co/docs/concepts/public-credentials)
- [Demand response](https://api.voltus.co/docs/concepts/demand_response)
- [Understanding curtailment plans](https://api.voltus.co/docs/concepts/curtailment_plans)
- [Start earning with Voltus](https://api.voltus.co/docs/concepts/start-earning-with-voltus)
- [Changelog](https://api.voltus.co/docs/changelog) ([RSS](https://api.voltus.co/docs/changelog/rss.xml), [Atom](https://api.voltus.co/docs/changelog/atom.xml))
- [Example code (Python)](https://github.com/voltusdev/voltus-api-examples)

## Specs and artifacts (API Evangelist)

- [OpenAPI](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/openapi/voltus-openapi.yml) - harvested from the portal build; Voltus serves no downloadable spec
- [Authentication](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/authentication/voltus-authentication.yml)
- [Conventions](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/conventions/voltus-conventions.yml)
- [Errors](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/errors/voltus-problem-types.yml)
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/rate-limits/voltus-rate-limits.yml)
- [Sandbox](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/sandbox/voltus-sandbox.yml)
- [Webhook catalog](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/asyncapi/voltus-webhooks.yml)
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/lifecycle/voltus-lifecycle.yml)
- [Changelog](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/changelog/voltus-changelog.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/data-model/voltus-data-model.yml)
- [Conformance](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/conformance/voltus-conformance.yml)
- [Agentic access](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/agentic-access/voltus-agentic-access.yml)
- [Agent skills](https://raw.githubusercontent.com/api-evangelist/voltus/refs/heads/main/skills/_index.yml)

## Access

- Sandbox: anonymous, self-serve, no key needed - use "secret" against sandbox.voltus.co.
- Production: partner-only. No self-serve signup, no public pricing. Voltus obtains a signed Letter of Authorization and utility bill per site, then issues a site-scoped production key. Contact api-support@voltus.co.