Skip to main content
The Wattsc REST API lets you pull energy readings, meter metadata, and alert history into your own applications. This guide shows you how to generate an API key, authenticate your requests, and make your first call to retrieve meter data.
1

Generate an API key

Go to Settings then API Access in your Wattsc account. Click Generate New Key, give it a descriptive name (for example, “BI Pipeline”), and copy the key immediately. You will not be able to view it again.
2

Authenticate your requests

Include the key in the Authorization header as a Bearer token on every request:
3

Make your first request

Use curl or any HTTP client to fetch the latest readings. Replace YOUR_API_KEY with the key you copied:
A successful response returns a JSON array of recent readings with timestamps, meter IDs, and consumption values.
Keep your API key secret. Do not commit it to source control or expose it in client-side code. If a key is compromised, revoke it immediately from Settings > API Access and generate a new one.

​
Rate limits

Rate limits vary by plan: If you exceed the limit, the API returns 429 Too Many Requests. Wait one minute before retrying, or implement exponential backoff in your client.

​
Next steps