Data schema
Every field you may send — with unit, type and sensitivity. Schema version 1.0.
Electrical channels
| Channel | Unit | Sensitivity | Meaning |
|---|---|---|---|
| frequency_hz | Hz | none | System frequency, node-global (~49–51 Hz on GB). |
| voltage_v | V | low | RMS voltage. A property of your local feeder, not you. |
| current_a | A | high | RMS current. Reveals household load; opt-in only. |
| power_w | W | high | Real power. Reveals household load; opt-in only. |
| power_factor | — | high | Power factor (−1..1). Reveals load character; opt-in only. |
| phase_angle_deg | deg | low | Synchrophasor angle vs UTC (GPS/PMU nodes only). |
Weather channels (all low sensitivity)
| Channel | Unit | Meaning |
|---|---|---|
| temp | degC | Ambient outdoor temperature. |
| rhum | % | Relative humidity. |
| wspd | km/h | Wind speed. |
| wdir | deg | Wind direction (met 'from', 0=N). |
| pres | hPa | Atmospheric pressure. |
| prcp | mm | Rainfall. |
| solar_radiation_w_m2 | W/m2 | Shortwave irradiance. |
| uv | index | UV index. |
Machine-readable contract
The published schema is the source of truth — code against it, not this page. The live API serves:
- /openapi.json — OpenAPI 3 spec (import into Postman, generate a client).
- gridwitness-ingest.v1.schema.json — JSON Schema (draft 2020-12) for every request/response body.
- channels.v1.json — the channel catalogue above, machine-readable.