Two endpoints return measurements for a station: the newest reading of each sensor, and a range of readings. Daily and hourly values are separate series; neither is computed from the other.
Latest conditions
GET /api/v1/stations/{station}/latest returns the newest reading that has a value for each sensor, such as a station's latest snow water equivalent or snow depth.
| Parameter | Meaning |
|---|---|
elements | Comma-separated element codes, up to 10. Default WTEQ,SNWD,PREC,TOBS. |
duration | DAILY or HOURLY. Default both. |
curl 'https://opensnotel.com/api/v1/stations/312:ID:SNTL/latest?elements=WTEQ&duration=DAILY'
{
"station": "312:ID:SNTL",
"data": [
{
"elementCode": "WTEQ",
"duration": "DAILY",
"ordinal": 1,
"heightDepthIn": null,
"unit": "in",
"observedAt": "2026-10-24T08:00:00.000Z",
"localDate": "2026-10-24",
"value": 0.1,
"flag": "R",
"qualityFlag": "V",
"isProvisional": null,
"sourceUpdatedAt": "2026-10-24T19:05:00.000Z",
"plausibilityFlags": [],
"newestObservedAt": "2026-10-24T08:00:00.000Z",
"freshness": { "state": "fresh", "staleAfterMinutes": 4320 }
}
],
"meta": { "generatedAt": "2026-10-25T16:48:16.000Z" }
}
Reading freshness
freshness.state says whether the data is reaching Snotel, which is not the same as whether the snow changed:
fresh: a recent period has a value. An unchanged or zero value is still fresh; no new snow is not stale data.no_values: periods keep arriving, but none recent has a value. The source is reporting the sensor as missing.newestObservedAtis later thanobservedAt.stale: no recent period has arrived, so the source or the feed is behind.staleAfterMinutesis the threshold for the duration: six hours for hourly readings, three days for daily.
Judge a reading by observedAt, the start of its period, not by when it was stored. Freshness explains the three times a value carries.
Observations over a range
GET /api/v1/stations/{station}/observations returns readings between two station-local dates, inclusive, grouped by sensor.
| Parameter | Meaning |
|---|---|
from | First local date, YYYY-MM-DD. Required. |
to | Last local date, YYYY-MM-DD, inclusive. Required. |
elements | Comma-separated element codes, up to 10. Default WTEQ,SNWD,PREC,TOBS. |
duration | DAILY (default) or HOURLY. |
A range is at most 366 days of DAILY data or 31 days of HOURLY data. For a longer history, request consecutive ranges. A requested element the station does not report at that duration answers 404 with element_unavailable.
curl 'https://opensnotel.com/api/v1/stations/312:ID:SNTL/observations?elements=WTEQ&from=2026-01-05&to=2026-01-06'
{
"station": "312:ID:SNTL",
"duration": "DAILY",
"from": "2026-01-05",
"to": "2026-01-06",
"utcOffsetMinutes": -480,
"data": [
{
"elementCode": "WTEQ",
"ordinal": 1,
"heightDepthIn": null,
"unit": "in",
"readings": [
{
"observedAt": "2026-01-05T08:00:00.000Z",
"localDate": "2026-01-05",
"value": 12.5,
"flag": "R",
"qualityFlag": "V",
"originalValue": 12.5,
"originalQualityFlag": "V",
"isProvisional": null,
"sourceUpdatedAt": "2026-01-06T19:05:00.000Z",
"revision": 1,
"plausibilityFlags": []
},
{
"observedAt": "2026-01-06T08:00:00.000Z",
"localDate": "2026-01-06",
"value": null,
"flag": null,
"qualityFlag": "S",
"originalValue": 12.9,
"originalQualityFlag": "V",
"isProvisional": null,
"sourceUpdatedAt": null,
"revision": 2,
"plausibilityFlags": []
}
]
}
],
"meta": { "generatedAt": "2026-10-23T21:20:00.000Z" }
}
The second reading is shown as the source blanked it, to illustrate a missing value. A range with no data answers 200 with an empty data array.
Reading a reading
valueisnullfor the second reading: the source marked it suspect (qualityFlagS) and reported no value.originalValuekeeps what was first received, so the evidence is not lost.flagandqualityFlagare the source's letters;isProvisionalistrueonly when the flag says provisional andfalseonly when it says reviewed.plausibilityFlagslists the checks a reading failed, such as a spike that reverses or a pillow reset to zero: Snotel's verdict that a sensor fault likely produced the value, which is still exactly what the source sent. An empty list means it passed every check. A missing value is never judged as zero. See quality for the checks and their thresholds. Latest readings carry the same field.revisioncounts the times Snotel stored a changed value for this reading, andsourceUpdatedAtis when the source last revised it. A reading you fetched yesterday for a recent day may differ today.- A daily reading covers the whole local day;
observedAtis its start. An hourly reading is the hour starting atobservedAt.