GridView Reporting API

Standalone reporting API and UI served from the reporting server. Default timezone: Africa/Johannesburg.

Protected JSON routes require an API key in X-API-Key or Authorization: Bearer <key>.

Endpoint Summary

• GET /health: service health and runtime metadata.
• GET /meters: list known meters in the local rollup store.
• GET /tariffs?meter=...: list tariff rules for one meter plus shared defaults.
• GET /usage/hourly?meter=...&start=...&end=...: hourly usage rows and summary totals.
• GET /api-info: compact discovery JSON for agents and client bootstrapping.
• GET /openapi.json: full OpenAPI contract.

Example Calls

curl -H "X-API-Key: YOUR_KEY" "http://gridview.reverse-proxy.co.za/meters"

curl -H "X-API-Key: YOUR_KEY" "http://gridview.reverse-proxy.co.za/tariffs?meter=meter-subtropico-fridge"

curl -H "X-API-Key: YOUR_KEY" "http://gridview.reverse-proxy.co.za/usage/hourly?meter=meter-subtropico-fridge&start=2026-03-01T00:00:00%2B02:00&end=2026-04-01T00:00:00%2B02:00"

Field Notes

• kwh_net: net energy for the hour bucket.
• rate_multiplier: tariff multiplier resolved onto that hour bucket.
• billed_kwh_weighted: kwh_net * rate_multiplier when a tariff rule matched.
• quality: rollup quality marker such as ok, partial, or reset_detected.