# OpenADR 3 API

**Canonical:** https://apis.io/apis/openadr-alliance/openadr-3-api/  
**Provider:** OpenADR Alliance — https://apis.io/providers/openadr-alliance/  
**Documentation:** https://www.openadr.org/specification

OpenADR 3 API is published by [OpenADR Alliance](https://apis.io/providers/openadr-alliance/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 1 JSON Schema definition. Tagged areas include Demand Response, OpenADR, Energy, and DER. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and 1 JSON Schema.

OpenADR 3 is the RESTful third generation of the OpenADR protocol, defined in full by a single OpenAPI 3.0 document published by the OpenADR Alliance. It supports energy-retailer-to-energy-customer demand response programs through operations to create, update, delete, and search programs, events, reports, subscriptions, VENs (Virtual End Nodes), and VEN resources, plus an /auth/token endpoint. Version 3.1.0 adds MQTT notifier topics, VEN-scoped topics for object privacy, and VTN discovery. Security is OAuth 2.0 client credentials with JWT bearer tokens and role-scoped grants that separate what a Business Logic (BL/VTN) client may write from what a VEN may write. This is a protocol contract, not an Alliance-hosted service — every implementer (a utility, aggregator, or vendor VTN) stands up its own base URL, so no single baseURL exists. The specification documents themselves are distributed by the Alliance through a registration form; the OpenAPI files harvested here came from a public Apache-2.0 copy of the Alliance release.

## Machine-readable artifacts (24)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/openapi/openadr-3-1-1-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/openapi/openadr-3-1-0-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/openapi/openadr-3-0-1-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/openapi/openadr-3-0-0-openapi.yaml
- **Documentation** — https://www.openadr.org/specification
- **Documentation** — https://www.openadr.org/how-to-build-a-product
- **Conformance** — https://www.openadr.org/openadr-3-certification
- **SourceCode** — https://github.com/grid-coordination/openadr3-specification
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/overlays/openadr-alliance-openadr-3-1-1-overlay.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/overlays/openadr-alliance-openadr-3-1-0-overlay.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/overlays/openadr-alliance-openadr-3-0-1-overlay.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/overlays/openadr-alliance-openadr-3-0-0-overlay.yaml
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/asyncapi/openadr-alliance-notifications-asyncapi.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/asyncapi/openadr-alliance-webhooks.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/json-schema/_index.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/examples/openadr-alliance-examples.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/data-model/openadr-alliance-data-model.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/errors/openadr-alliance-problem-types.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/mcp/openadr-alliance-tool-crosswalk.yml
- **MCPCandidate** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/mcp/openadr-alliance-mcp.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/apis.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/arazzo/_index.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/arazzo/openadr-alliance-dispatch-event.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/openadr-alliance/refs/heads/main/arazzo/openadr-alliance-ven-onboard-and-subscribe.yml

## Tags

Demand Response, OpenADR, Energy, DER

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/openadr-alliance/openadr-3-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/openadr-alliance/.