# Clevergy Connect API

**Canonical:** https://apis.io/apis/clevergy/clevergy-connect-api/  
**Provider:** Clevergy — https://apis.io/providers/clevergy/  
**Base URL:** https://connect.clever.gy  
**Documentation:** https://docs.clever.gy/connect-api/clevergy-connect-api

Clevergy Connect API is one of 3 APIs that [Clevergy](https://apis.io/providers/clevergy/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Energy, Energy Management, Utilities, Smart Meter, and Solar. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

REST API that lets Clevergy customers build integrations with the Clevergy platform: manage end users and their houses, create and maintain electricity and gas contracts with their energy price tables, upload and OCR-analyse invoices, define custom tariffs, discover and link solar inverter installations, read energy, power, comparison and appliance-disaggregation telemetry, monitor and schedule home batteries, manage energy-community membership and shares, post virtual wallet (EUR) and virtual battery (kWh) balances, and work support tickets and sales opportunities. Published as a Swagger 2.0 document with 62 paths, 83 operations, 102 definitions and an operationId on every operation. Authentication is a tenant API key in the clevergy-api-key header; a separate operation exchanges it for a 1-hour per-user JWT for browser use. Access is sales-gated — keys are issued per environment on request.

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/openapi/clevergy-connect-api-openapi.yml
- **OpenAPI** — https://assets.clever.gy/swagger/connect-api.yaml
- **Documentation** — https://docs.clever.gy/developer
- **APIReference** — https://docs.clever.gy/connect-api/clevergy-connect-api
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/authentication/clevergy-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/conventions/clevergy-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/errors/clevergy-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/data-model/clevergy-data-model.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/lifecycle/clevergy-lifecycle.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/rate-limits/clevergy-rate-limits.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/conformance/clevergy-conformance.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/overlays/clevergy-connect-api-overlay.yaml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/asyncapi/clevergy-webhooks.yml
- **Postman** — https://www.postman.com/clevergy/clevergy-public-workspace
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/clevergy/refs/heads/main/apis.yml

## Other Clevergy APIs (2)

- [Clevergy Webhooks](https://apis.io/apis/clevergy/clevergy-webhooks/)
- [Clevergy Microfrontends](https://apis.io/apis/clevergy/clevergy-microfrontends/)

## Tags

Energy, Energy Management, Utilities, Smart Meter, Solar, Battery Storage, Home Energy, Spain

---

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