# Wattwatchers Devices API

**Canonical:** https://apis.io/apis/wattwatchers/wattwatchers-devices-api/  
**Provider:** Wattwatchers — https://apis.io/providers/wattwatchers/  
**Base URL:** https://api-v3.wattwatchers.com.au  
**Documentation:** https://docs.wattwatchers.com.au/api/v3/index.html

Wattwatchers Devices API is one of 4 APIs that [Wattwatchers](https://apis.io/providers/wattwatchers/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Devices. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and a changelog.

Operations related to devices

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/devices` | Get devices |
| GET | `/devices/{device-id}` | Get device details |
| PATCH | `/devices/{device-id}` | Patch device metadata and state |
| GET | `/devices/channel-categories` | Get category definitions for device channels |
| GET | `/devices/models` | Get valid device models |

## Machine-readable artifacts (23)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/wattwatchers/refs/heads/main/openapi/wattwatchers-devices-api-openapi.yml
- **Documentation** — https://docs.wattwatchers.com.au/api/v3/index.html
- **APIReference** — https://docs.wattwatchers.com.au/api/v3/endpoints.html
- **InteractiveDocumentation** — https://docs.wattwatchers.com.au/api/v3/openapi/index.html
- **Authentication** — https://docs.wattwatchers.com.au/api/v3/auth.html
- **RateLimits** — https://docs.wattwatchers.com.au/api/v3/rate-limits.html
- **Errors** — https://docs.wattwatchers.com.au/api/v3/errors.html
- **Conventions** — https://docs.wattwatchers.com.au/api/v3/conventions.html
- **ChangeLog** — https://docs.wattwatchers.com.au/api/v3/release-notes.html
- **Documentation** — https://docs.wattwatchers.com.au/api/v3/phase-grouping.html
- **Documentation** — https://docs.wattwatchers.com.au/api/v3/v2-diff.html
- **Documentation** — https://docs.wattwatchers.com.au/api/tips/concepts.html
- **Documentation** — https://docs.wattwatchers.com.au/api/tips/polling-data.html
- **Documentation** — https://docs.wattwatchers.com.au/api/tips/device-catch-up.html
- **Documentation** — https://docs.wattwatchers.com.au/api/tips/modbus-data.html
- **Documentation** — https://docs.wattwatchers.com.au/api/tips/units-conversion.html
- **Documentation** — https://docs.wattwatchers.com.au/api/tips/working-with-timestamps.html
- **Documentation** — https://docs.wattwatchers.com.au/api/tips/switching-example.html
- **SampleCode** — https://github.com/wattwatchers/rest-api-notebooks
- **Examples** — https://raw.githubusercontent.com/api-evangelist/wattwatchers/refs/heads/main/examples/wattwatchers-rest-api-v3-examples.json
- **Roadmap** — https://docs.wattwatchers.com.au/api/roadmap.html
- **GettingStarted** — https://service.wattwatchers.com.au/getting-started-with-wattwatchers
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/wattwatchers/refs/heads/main/apis.yml

## Other Wattwatchers APIs (3)

- [Wattwatchers Long Energy API](https://apis.io/apis/wattwatchers/wattwatchers-long-energy-api/)
- [Wattwatchers Modbus API](https://apis.io/apis/wattwatchers/wattwatchers-modbus-api/)
- [Wattwatchers Short Energy API](https://apis.io/apis/wattwatchers/wattwatchers-short-energy-api/)

## Tags

Devices

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/wattwatchers/wattwatchers-devices-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/wattwatchers/.