# Gravity Connect API (Device Partner)

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

Gravity Connect API (Device Partner) 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, Device Control, OEM, and Authentication. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, an engineering blog, and a getting-started guide.

The Device Partner half of Virtual Peaker's Gravity Connect specification — the endpoints a device OEM must implement so a VPP or DERMS platform can discover, enroll, read, group, and command its behind-the-meter DER devices. Version 2.0.6, OpenAPI 3.0.0, 14 paths / 18 operations across Devices, Commands, Device Partner Driven Enrollment, OAuth Device Discovery, Pairing Code Device Discovery (end-user app and utility-commissioned installation), Group Management, and an Energy Interval endpoint. The published `servers` entry is the placeholder https://example.com because the OEM, not Virtual Peaker, hosts this surface. Secured with OAuth 2.0 — client credentials (scope basic_partner_read_write) for platform-to-partner calls, and authorization code (scope user_read) for homeowner-consented device discovery.

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/virtual-peaker/refs/heads/main/openapi/virtual-peaker-gravity-connect-device-partner-api-openapi.yml
- **APIReference** — https://assets.virtualpeaker.io/gravity-connect/device-partner-api.html
- **Documentation** — https://virtual-peaker.com/partners/device-partners/
- **Blog** — https://virtual-peaker.com/blog/gravity-connect-api-oem-derms-integrations/
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/virtual-peaker/refs/heads/main/overlays/virtual-peaker-gravity-connect-device-partner-api-overlay.yaml
- **GettingStarted** — https://assets.virtualpeaker.io/gravity-connect/device-partner-api.html#section/Getting-Started
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/virtual-peaker/refs/heads/main/apis.yml

## Other Virtual Peaker APIs (1)

- [Gravity Connect API (Virtual Peaker)](https://apis.io/apis/virtual-peaker/gravity-connect-vpp-api/)

## Tags

DER, Demand Response, Device Control, OEM, Authentication

---

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