WattGap versions public REST APIs in the URL path. The current Energy Intelligence API is /api/v1.
Breaking changes require a new major version path (/api/v2). Additive, backwards-compatible changes may land in the current major version.
When a version is deprecated, responses include RFC 9745 Deprecation and Sunset headers, and this page is updated with the sunset date. No current WattGap API version is deprecated.
Error responses use RFC 9457 application/problem+json with a machine-readable code and a human-readable detail (also copied to error for compatibility).
Rate-limit conventions: IETF RateLimit and RateLimit-Policy structured fields, plus Retry-After on HTTP 429.