← Back to API Reference

API: Device Status

The status endpoint returns a complete snapshot of your Annaboto's current state — sensor readings, grow progress, plant info, and hardware status.

GET /status

Returns the full device state in a single request. This is the primary endpoint for monitoring your grow.

Example Request

curl http://192.168.0.103:8080/annaboto/api/status

Response Fields

Field	Type	Description
recipe	string	Active recipe name (e.g., "grow", "idle")
recipe_step	string	Current step in the recipe (e.g., "week3", "start")
week	integer	Current grow week number
current_day	integer	Days since grow started (-1 if no active grow)
grow_length_days	integer	Total expected grow duration in days (0 if no active grow)
grow_state	string	Grow status: "GROWING", "IDLE", or "unknown"
plant_name	string	User-assigned plant name (reads from config/user "plant" field)
temperature	float	Current temperature in Celsius
humidity	float	Current relative humidity percentage
min_temperature	float	Configured minimum temperature bound (Celsius)
max_temperature	float	Configured maximum temperature bound (Celsius)
min_humidity	float	Configured minimum humidity bound (%)
max_humidity	float	Configured maximum humidity bound (%)
fresh_water	float	Fresh water tank level
grow_water	float	Grow water tank level
waste_water	float	Waste water tank level
outputs.notifications	object	Active device notifications (tag → message dictionary)

Grow State Values

• GROWING — An active grow is in progress
• IDLE — No active grow (device is waiting)
• unknown — State could not be determined (usually a firmware issue)

No Active Grow

When no grow is active, the response will show:

• recipe: "idle"
• recipe_step: "start"
• current_day: -1
• grow_length_days: 0
• grow_state: "IDLE"

Notes

• Temperature and humidity bounds are read from the device's io_state outputs. If they return 0, the device may need a firmware update.
• The plant_name field reflects the most recent value written via PUT /config/user with the "plant" key.
• Use GET /version as a lightweight connectivity check instead of /status if you only need to verify the device is reachable.