Skip to main content
Partner API

Energy cooperative data, built for developers

Programmatic access to the valueverde platform: browse the cooperative catalogue, provision investors, and place share purchases on their behalf. OAuth2 client_credentials in, JSON out.

Get startedAPI reference
Resources
Quick start

Mint a token and call /v1/cooperatives in under five minutes.

Read guide →
API reference

Full schemas for the catalogue, managed investors, and share purchases.

Browse →
Errors

RFC 9457 Problem Details, every code, retry guidance.

View codes →
What you can rely on

Built to last

Every guarantee below applies to every endpoint, every token, every request — no premium tier required.

OAuth2 client_credentials

RS256 access tokens, 15-minute TTL, JWKS-published verification keys. No secrets on the wire after token mint.

Learn more →
Stable contract

RFC 9457 Problem Details with stable error codes. snake_case field names. Forward-compatible — clients tolerate unknown fields.

Learn more →
Predictable pagination

One-based page/size with total_items and has_next. Six sort tokens. Filter combinations are pure AND.

Learn more →
Defense in depth

TLS 1.2+, HSTS preload, frame-deny, strict referrer policy. 90-day request audit. Argon2id-hashed client secrets.

Learn more →
eu-central-1

All data stored in Frankfurt with cross-AZ replication. No US or APAC replica.

Learn more →
Honest deprecation

Forward-compatible additions are silent. Breaking changes get a new URL prefix and a 12-month dual-run window.

Learn more →

Endpoints

One contract, under /v1. OAuth2 throughout.

Catalogue
GET/v1/cooperatives
GET/v1/cooperatives/{id}
Managed investors
POST/v1/investors
PUT/v1/investors/{id}/profile
Investments
POST/v1/investors/{id}/share-purchases
GET/v1/investors/{id}/holdings
Auth
POST/oauth2/token
GET/.well-known/jwks.json