aid: wattwatchers url: https://raw.githubusercontent.com/api-evangelist/wattwatchers/refs/heads/main/apis.yml name: Wattwatchers kind: company description: 'Wattwatchers is an Australian digital energy company (founded 2007, headquartered in Sydney, NSW) that designs and manufactures the Auditor family of DIN-rail electricity monitoring and switching devices, and operates the cloud platform behind them. It sits behind the meter rather than at it — Auditors clamp onto individual circuits and report real-time, circuit-level energy data over 4G or WiFi to Wattwatchers'' hosted platform, which resells that data to solar installers, energy retailers, energy services companies, EV and DER programs, schools and research trials. Its API posture is genuinely open at the documentation layer and closed at the data layer — the full REST API v3 (Mercury) reference, a live Swagger UI and a downloadable OpenAPI 3.0 contract are all served anonymously from docs.wattwatchers.com.au, but no key is self-serve: Wattwatchers issues bearer tokens by hand and scopes each one to the specific devices you own or manage, so the API returns your fleet''s data and nothing else. Consumer usage data is therefore available through a documented API, while no open grid or market data is published at all. Wattwatchers is not a designated Consumer Data Right energy data holder and does not appear as an accredited data recipient — the CDR energy mandate applies to retailers and AEMO, not to behind-the-meter hardware vendors, so this platform carries no CDR obligation and implements no CDR or Green Button data standard. Wattwatchers entered voluntary administration in October 2025 and was acquired by EPX Limited (ASX:EPX, formerly EP&T Global); the Wattwatchers knowledge base now redirects to support.epx.tech, while the developer documentation, the API host and the OpenAPI contract all remain live and unchanged.' image: https://docs.wattwatchers.com.au/assets/images/favicon.png tags: - Energy - Australia - Utilities - Electricity - Smart Metering - Energy Data - IoT - Solar - DER - Demand Response created: '2026-07-27' modified: '2026-07-27' specificationVersion: '0.19' apis: - aid: wattwatchers:wattwatchers-rest-api-v3 name: Wattwatchers REST API v3 (Mercury) description: The Wattwatchers REST API v3, code-named Mercury — 14 documented operations across 13 paths, covering device inventory and configuration (including switch control via PATCH), 30-second "short energy" interval data, 5-minute "long energy" interval data, and Modbus data read from downstream devices by 6M+One hardware. Authentication is a Wattwatchers-issued bearer API key scoped to the devices assigned to that key. Version 3.6.0 of the published OpenAPI contract. humanURL: https://docs.wattwatchers.com.au/api/v3/index.html baseURL: https://api-v3.wattwatchers.com.au tags: - Devices - Short Energy - Long Energy - Modbus - Energy Data - Smart Metering properties: - type: OpenAPI url: openapi/wattwatchers-rest-api-v3-openapi.json - type: Documentation url: https://docs.wattwatchers.com.au/api/v3/index.html - type: APIReference url: https://docs.wattwatchers.com.au/api/v3/endpoints.html - type: InteractiveDocumentation url: https://docs.wattwatchers.com.au/api/v3/openapi/index.html - type: Authentication url: https://docs.wattwatchers.com.au/api/v3/auth.html - type: RateLimits url: https://docs.wattwatchers.com.au/api/v3/rate-limits.html - type: Errors url: https://docs.wattwatchers.com.au/api/v3/errors.html - type: Conventions url: https://docs.wattwatchers.com.au/api/v3/conventions.html - type: ChangeLog url: https://docs.wattwatchers.com.au/api/v3/release-notes.html - type: Documentation url: https://docs.wattwatchers.com.au/api/v3/phase-grouping.html - type: Documentation url: https://docs.wattwatchers.com.au/api/v3/v2-diff.html - type: Documentation url: https://docs.wattwatchers.com.au/api/tips/concepts.html - type: Documentation url: https://docs.wattwatchers.com.au/api/tips/polling-data.html - type: Documentation url: https://docs.wattwatchers.com.au/api/tips/device-catch-up.html - type: Documentation url: https://docs.wattwatchers.com.au/api/tips/modbus-data.html - type: Documentation url: https://docs.wattwatchers.com.au/api/tips/units-conversion.html - type: Documentation url: https://docs.wattwatchers.com.au/api/tips/working-with-timestamps.html - type: Documentation url: https://docs.wattwatchers.com.au/api/tips/switching-example.html - type: SampleCode url: https://github.com/wattwatchers/rest-api-notebooks - type: Overlay url: overlays/wattwatchers-rest-api-v3-overlay.yaml - type: Examples url: examples/wattwatchers-rest-api-v3-examples.json - type: Roadmap url: https://docs.wattwatchers.com.au/api/roadmap.html - type: GettingStarted url: https://service.wattwatchers.com.au/getting-started-with-wattwatchers common: - type: AgenticAccess url: agentic-access/wattwatchers-agentic-access.yml - type: DomainSecurity url: security/wattwatchers-domain-security.yml - type: Authentication url: authentication/wattwatchers-authentication.yml - type: Website url: https://wattwatchers.com.au/ - type: Documentation url: https://docs.wattwatchers.com.au/ - type: InteractiveDocumentation url: https://docs.wattwatchers.com.au/api/v3/openapi/index.html - type: Authentication url: https://docs.wattwatchers.com.au/api/v3/auth.html - type: RateLimits url: https://docs.wattwatchers.com.au/api/v3/rate-limits.html - type: ChangeLog url: https://docs.wattwatchers.com.au/api/v3/release-notes.html - type: GitHubOrganization url: https://github.com/wattwatchers - type: SampleCode url: https://github.com/wattwatchers/rest-api-notebooks - type: LinkedIn url: https://www.linkedin.com/company/wattwatchers-digital-energy - type: Support url: https://service.wattwatchers.com.au/ - type: Applications url: https://docs.wattwatchers.com.au/apps.html - type: DeveloperPortal url: https://docs.wattwatchers.com.au/ - type: APIReference url: https://docs.wattwatchers.com.au/api/v3/endpoints.html - type: GettingStarted url: https://service.wattwatchers.com.au/getting-started-with-wattwatchers - type: Roadmap url: https://docs.wattwatchers.com.au/api/roadmap.html - type: Packages url: packages/wattwatchers-packages.yml - type: ErrorCatalog url: errors/wattwatchers-error-codes.yml - type: Conventions url: conventions/wattwatchers-conventions.yml - type: RateLimits url: rate-limits/wattwatchers-rate-limits.yml - type: Lifecycle url: lifecycle/wattwatchers-lifecycle.yml - type: ChangeLog url: changelog/wattwatchers-changelog.yml - type: Conformance url: conformance/wattwatchers-conformance.yml - type: DataModel url: data-model/wattwatchers-data-model.yml - type: MCPServer url: mcp/wattwatchers-mcp.yml - type: LLMsTxt url: llms/wattwatchers-llms.txt - type: AgentSkill url: skills/_index.yml - type: Examples url: examples/wattwatchers-rest-api-v3-examples.json - type: Overlay url: overlays/wattwatchers-rest-api-v3-overlay.yaml maintainers: - FN: Kin Lane email: kin@apievangelist.com