API Documentation

Integrate EnergyMonitor data into your applications with our REST API. Access sensor data, manage alerts, and automate your workflows.

Get Your API Key

Base URL

https://api.energymonitor.fi

Authentication

Bearer token in Authorization header

Rate Limits

100 requests/minute (Basic), 1000/minute (Pro)

Authentication

All API requests require authentication using an API key.

Getting your API key

Log in to your EnergyMonitor dashboard
Go to Settings > API Keys
Click "Generate New Key"
Copy and securely store your key

Using your API key

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Quick Start

Get started with these code examples

curl -X GET "https://api.energymonitor.fi/v1/api/devices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API Endpoints

Available endpoints for device and alarm management

GET /v1/api/devices

List all devices in your organization

GET /v1/api/devices/{id}

Get a specific device by ID

GET /v1/api/devices/{id}/metrics

Get sensor metrics for a device

GET /v1/api/alarms/defaults

List alarm threshold defaults

POST /v1/api/alarms/defaults

Create a new alarm threshold

GET /v1/api/alarms/events

List alarm events

This is a simplified overview. For complete API documentation including request/response schemas, error codes, and more examples, see our full API reference.

Full Documentation

Rate Limits

API rate limits vary by plan

Plan	Rate Limit	Burst
Free	10 requests/minute	20 requests
Basic	100 requests/minute	200 requests
Pro	1000 requests/minute	2000 requests
Enterprise	Custom	Custom

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Need Help?

Our team is here to help you integrate with the API

Contact Support Browse Documentation