📡 Strawberry Creek API Documentation

The Strawberry Creek Monitoring API provides real-time and historical environmental sensor data. Query data by creek site, time range, and variables — and build on top of our open-source water monitoring system. Reading data is open and needs no token; only uploading new readings requires one.

🔗 GET Endpoint

GET /api/creek-data/

🔓 Reading Data (no token)

Reading data with GET is open — no token or Authorization header is required. (A token is only needed to upload data; see below.)

📥 Required Parameters (GET)

  • site — table name (e.g. north_fork_0)
  • start — start time (ISO 8601 format)
  • end — end time (ISO 8601 format)
  • vars — comma-separated list of columns to return (e.g. vars=Meter_Hydros21_Cond,Meter_Hydros21_Temp)

🎛 Notes on vars

  • timestamp is always included in the response — you don't need to list it in vars.
  • Names in vars that don't exist on that site's table are ignored. If none of them match, the response is an empty list.

🧪 Example GET Request

curl "https://www.strawberrycreek.org/api/creek-data/?site=north_fork_0&start=2025-04-01T00:00:00&end=2025-04-07T00:00:00&vars=Meter_Hydros21_Cond"

📦 Example GET Response

[
  {
    "timestamp": "2025-04-06 01:45:00",
    "Meter_Hydros21_Cond": 419.7
  },
  {
    "timestamp": "2025-04-06 02:00:00",
    "Meter_Hydros21_Cond": 419.7
  }
]

📤 Upload Sensor Data

Send new sensor data to a specific creek site (table).

🔗 Endpoint

POST /api/upload-sensor-data/

🔐 Authentication (POST)

Uploads require an API token in the request header:

Authorization: Token your_token_here

📥 Required JSON Fields

  • site — table name (e.g. north_fork_0)
  • timestamp — ISO datetime (e.g. 2025-05-01T13:00:00)

🎛 Optional JSON Fields

  • Meter_Hydros21_Cond
  • Meter_Hydros21_Depth
  • Meter_Hydros21_Temp
  • EnviroDIY_Mayfly_Batt
  • EnviroDIY_Mayfly_Signal
  • TE_TR_525USW_Precip_5minTotal
  • Sensirion_SHT40_Humidity
  • Sensirion_SHT40_Temperature
  • AOSong_AM2315C_Temp
  • AOSong_AM2315C_Humidity

🧪 Example POST Request

curl -X POST https://www.strawberrycreek.org/api/upload-sensor-data/ \
-H "Authorization: Token your_token_here" \
-H "Content-Type: application/json" \
-d '{
  "site": "north_fork_0",
  "timestamp": "2025-05-01T13:00:00",
  "Meter_Hydros21_Cond": 123.45,
  "EnviroDIY_Mayfly_Batt": 3.9
}'

📦 Success Response

{
  "message": "Data inserted successfully."
}

🚫 Error Responses

  • 400 — Missing or invalid parameters
  • 401 — Authentication credentials were not provided
  • 404 — Site/table not found
  • 500 — Internal server error

📮 Get a Token

You only need a token to upload sensor data — reading data back out is open and needs no token.

Email us at strawberrycreekmonitoringgroup@gmail.com to get an API token for uploads.

Already have an account? Fill out this form: