Emoncms API
Post data from your own devices and scripts, read back recorded data and configuration.
Your API keys
There are two API keys: a read only key, safe to use in dashboards and shared links, and a read & write key that lets devices post data to your account.
Log in or create an account to get your keys.
Three ways to authenticate
No HTTPS on your device? Emoncms also supports AES-128-CBC encrypted posting using your API key as a pre-shared key. See the reference below.
Send your first data
Three steps, nothing to install, just your browser
Copy this URL
It posts a value of 100 to an input called power1 on a device named emontx. Log in and your write key is filled in automatically.
Open it in a new tab
The server replies to confirm your data was received:
Watch it arrive
Your new input appears on the Inputs page, ready to log to a feed.
Then go further
Each guide opens the relevant part of the API reference below
Set the time yourself
Timestamp readings with the time parameter, in unix seconds or ISO 8601.
Upload history in bulk
input/bulk sends many readings from many devices in one request.
Post from scripts
Endpoints below have ready-made curl commands to copy.
Read your data back
Fetch live values and history with the feed API for your own apps.
API reference
Full input, feed, device and process API reference
{{ module.name }} · {{ group.name }}
{{ e.notes }}
POST body: {{ display_body(e) }}&apikey={{ key_trunc(e) }}…
{{ e.loading ? '...' : e.response }}
No endpoints match your filter
Using an AI assistant to write API client code? Point it at the machine readable reference: site/api.md · site/api.json · llms.txt