Moisture API Documentation

All API requests require a valid API key as a query parameter:
?api_key=YOUR_API_KEY_HERE

Device Registration

You must register your device(s) before accessing their data.
Go to your dashboard and use the "Register Device" button.
Enter your device's 16-character EUI (hex, case-insensitive).
Limit: Up to 10 devices per user (default).

Endpoints

Query Moisture Data

GET /moisture/api/moisture.php?api_key=YOUR_API_KEY&dev_eui=YOUR_DEVICE_EUI&hours=24
GET /moisture/api/moisture.php?api_key=YOUR_API_KEY&dev_eui=YOUR_DEVICE_EUI&count=10

Parameter	Type	Required?	Description
`api_key`	string	Yes	Your API key (from dashboard)
`dev_eui`	string	Yes	Your registered device EUI (16 hex chars)
`hours`	integer	One of `hours` or `count` required	Number of hours to look back (max: 168). Returns all readings in this time window (up to 500 results).
`count`	integer	One of `hours` or `count` required	Number of most recent readings to return (max: 500).

Examples:

Get last 24 hours:
/moisture/api/moisture.php?api_key=...&dev_eui=ce9c49e5db72508d&hours=24
Get last 10 readings:
/moisture/api/moisture.php?api_key=...&dev_eui=ce9c49e5db72508d&count=10

Sample response:

[
  {
    "dev_eui": "ce9c49e5db72508d",
    "timestamp": "2025-08-07 07:11:25",
    "raw_value": "14543",
    "percent": "1.04932"
  },
  ...
]

Notes:

Results are always sorted oldest → newest.
You can only fetch data for devices you have registered.
If not enough data exists for your query, you'll receive all available in range.

Register a Device

Go to your dashboard and click "Register Device".
Each device must have a unique 16-character EUI (hex).

You can also delete a device registration from the dashboard at any time.

Generate/Revoke API Key

Use your dashboard to generate new API keys.
You can have up to 25 active API keys at any time.
You can generate at most 5 new keys per hour (even if you revoke old keys).
Revoked keys still count towards the hourly generation limit.
Your API key is shown only once after creation—copy and store it securely!

Integrations

You can forward your device’s data automatically to external IoT platforms like ThingSpeak.
Set up and manage integrations from your dashboard integration page.

Errors & Status Codes

Rate Limits

Data API: 100 requests per hour per API key.
{"error": "Rate limit exceeded. Try again later."}
Key Generation:
- 5 new API keys per hour per user. (Revoked keys still count towards this hourly limit.)
- 25 active API keys per user at a time. (Revoke old keys to create new ones, subject to the hourly limit.)
If you exceed this, you'll see an error on your dashboard:
Rate limit exceeded: Max 5 API keys per hour.
Key limit: You can have a maximum of 25 active API keys. Please revoke an old key first.
Device Registration: 10 devices per user (default).
If you attempt to add more, registration will fail.
API Query:
- count max: 500
- hours max: 168 (7 days)

Note: Rate limits reset every hour, at the top of the hour.