# Gravity Connect API (Virtual Peaker)

**Canonical:** https://apis.io/apis/virtual-peaker/gravity-connect-vpp-api/  
**Provider:** Virtual Peaker — https://apis.io/providers/virtual-peaker/  
**Base URL:** https://partner.virtualpeaker.io/v1  
**Documentation:** https://assets.virtualpeaker.io/gravity-connect/vp-api.html

Gravity Connect API (Virtual Peaker) is one of 2 APIs that [Virtual Peaker](https://apis.io/providers/virtual-peaker/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include DER, Demand Response, Publishing, Webhook, and HMAC. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and an engineering blog.

The VPP half of the Gravity Connect specification — the publishing endpoints Virtual Peaker hosts so an integrated device partner can stream device signals, settings, command status, and enrollment events back into the platform. Version 2.0.6, OpenAPI 3.0.0, 5 paths / 5 operations, all under the Publishing tag and all keyed on a per-program PROGRAM_PUBLISH_KEY. Base URL https://partner.virtualpeaker.io/v1, confirmed live (AWS API Gateway, anonymous request returns HTTP 403 MissingAuthenticationTokenException). Authentication is not OAuth on this side: requests are signed with an HMAC-SHA256 of the request body using a PROGRAM_PUBLISH_SECRET or DEVICE_PUBLISH_SECRET and sent as `Authorization: Publish <hmac>`.

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/virtual-peaker/refs/heads/main/openapi/virtual-peaker-gravity-connect-vpp-api-openapi.yml
- **APIReference** — https://assets.virtualpeaker.io/gravity-connect/vp-api.html
- **Documentation** — https://virtual-peaker.com/apis/
- **Blog** — https://virtual-peaker.com/blog/gravity-connect-v-openadr/
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/virtual-peaker/refs/heads/main/overlays/virtual-peaker-gravity-connect-vpp-api-overlay.yaml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/virtual-peaker/refs/heads/main/asyncapi/virtual-peaker-gravity-connect-webhooks.yml

## Other Virtual Peaker APIs (1)

- [Gravity Connect API (Device Partner)](https://apis.io/apis/virtual-peaker/gravity-connect-device-partner-api/)

## Tags

DER, Demand Response, Publishing, Webhook, HMAC

---

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