API Changelog

A complete history of changes to the ClauseHub APIs. We follow semantic versioning.

v1.3.0 10 March 2026 Feature
  • Added public search endpoint (GET /tariffs/search/public) — no authentication required
  • Added bulk tariff creation endpoint (POST /suppliers/{id}/tariffs/bulk) — up to 100 items per request
  • Added consumableRange filter to search endpoints
v1.2.0 24 February 2026 Feature
  • Added version history endpoints for all resource types (GET /{resource}/{id}/versions)
  • Added updatedSince query parameter for filtering recently changed tariffs
  • Added GET /tariffs/recent endpoint
v1.1.0 10 February 2026 Improvement
  • Improved cursor-based pagination with JSON:API links object
  • Added rate limiting headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset)
  • Added OpenAPI specification endpoint at GET /schema
v1.0.0 27 January 2026 Launch
  • Initial release of the Energy API
  • Full CRUD for suppliers, tariffs, consumables, contracts, regions, payment methods
  • JSON:API v1.0 compliant responses
  • Supabase JWT authentication with role-based access control (admin, supplier, consumer)
  • Immutable versioning across all resources
  • 14 DNO regions with PES codes
  • Health check endpoint at GET /health