Skip to content
Open Snotel home
API

Weather

Get the weather around a SNOTEL station: the newest NWS forecast for its grid cell, nearby NWS observations and active alerts, each labeled observed or forecast and where it was measured.

GET /api/v1/stations/{station}/weather returns the weather around a station: its own air temperature, observations from nearby National Weather Service stations, the newest NWS forecast for its grid cell, and the NWS alerts in effect there. It is context for the snowpack, not a weather service: the station's snow and water measurements are the observations endpoints.

Everything comes from what Open SNOTEL has already stored. A request never reaches NWS, so the answer is as fresh as the last scheduled read, and each part says how fresh that is.

curl 'https://opensnotel.com/api/v1/stations/312:ID:SNTL/weather'
{
  "station": "312:ID:SNTL",
  "data": {
    "observed": {
      "primary": {
        "kind": "nws_observation",
        "temperature": { "value": 26.6, "unit": "degF" },
        "observedAt": "2026-10-25T13:19:00.000Z",
        "sourceId": "TCFI1",
        "sourceName": "TOWN CREEK",
        "distanceKm": 66.4,
        "elevationDifferenceFt": -2396
      },
      "snotel": null,
      "nearby": [
        {
          "kind": "nws_observation",
          "source": {
            "provider": "nws",
            "providerStationId": "TCFI1",
            "name": "TOWN CREEK",
            "network": "RAWS",
            "latitude": 43.93958,
            "longitude": -115.91153,
            "elevationFt": 4645,
            "distanceKm": 66.4,
            "elevationDifferenceFt": -2396,
            "rank": 1
          },
          "observedAt": "2026-10-25T13:19:00.000Z",
          "temperature": { "value": 26.6, "unit": "degF" },
          "dewpoint": { "value": 17.6, "unit": "degF" },
          "relativeHumidity": { "value": 68, "unit": "percent" },
          "windSpeed": { "value": 10, "unit": "mph" },
          "windGust": { "value": null, "unit": "mph" },
          "windDirection": { "value": 270, "unit": "degree_(angle)" },
          "description": null,
          "freshness": {
            "state": "fresh",
            "asOf": "2026-10-25T13:19:00.000Z",
            "staleAfterMinutes": 180
          }
        }
      ]
    },
    "forecast": {
      "kind": "nws_forecast",
      "grid": {
        "office": "BOI",
        "gridX": 170,
        "gridY": 112,
        "elevationFt": 7041
      },
      "issuedAt": "2026-10-25T09:56:09.000Z",
      "fetchedAt": "2026-10-25T10:05:12.000Z",
      "checkedAt": "2026-10-25T13:05:03.000Z",
      "freshness": {
        "state": "fresh",
        "asOf": "2026-10-25T13:05:03.000Z",
        "staleAfterMinutes": 180
      },
      "periods": [
        {
          "number": 1,
          "name": "Today",
          "startsAt": "2026-10-25T12:00:00.000Z",
          "endsAt": "2026-10-26T00:00:00.000Z",
          "isDaytime": true,
          "temperature": { "value": 44, "unit": "degF" },
          "temperatureTrend": null,
          "precipitationProbability": { "value": 20, "unit": "percent" },
          "windSpeedText": "5 to 10 mph",
          "windSpeedMin": { "value": 5, "unit": "mph" },
          "windSpeedMax": { "value": 10, "unit": "mph" },
          "windGust": { "value": null, "unit": "mph" },
          "windDirection": "SW",
          "shortForecast": "Slight Chance Snow Showers",
          "detailedForecast": "A slight chance of snow showers after noon. Mostly sunny, with a high near 44."
        }
      ],
      "hourly": [
        {
          "startsAt": "2026-10-25T13:00:00.000Z",
          "temperature": { "value": 28, "unit": "degF" },
          "dewpoint": { "value": 21, "unit": "degF" },
          "relativeHumidity": { "value": 74, "unit": "percent" },
          "precipitationProbability": { "value": 2, "unit": "percent" },
          "windSpeed": { "value": 3.5, "unit": "mph" },
          "windGust": { "value": 6.9, "unit": "mph" },
          "windDirection": { "value": 180, "unit": "degree_(angle)" },
          "snowLevel": { "value": 5302, "unit": "ft" }
        }
      ],
      "snowfall": {
        "unit": "in",
        "values": [
          {
            "validFrom": "2026-10-26T12:00:00.000Z",
            "validTo": "2026-10-26T18:00:00.000Z",
            "value": 0.4
          }
        ]
      },
      "quantitativePrecipitation": {
        "unit": "in",
        "values": [
          {
            "validFrom": "2026-10-26T12:00:00.000Z",
            "validTo": "2026-10-26T18:00:00.000Z",
            "value": 0.05
          }
        ]
      },
      "snowLevel": {
        "unit": "ft",
        "values": [
          {
            "validFrom": "2026-10-26T12:00:00.000Z",
            "validTo": "2026-10-26T13:00:00.000Z",
            "value": 5302
          }
        ]
      }
    },
    "alerts": {
      "checkedAt": "2026-10-25T13:18:02.000Z",
      "freshness": {
        "state": "fresh",
        "asOf": "2026-10-25T13:18:02.000Z",
        "staleAfterMinutes": 45
      },
      "items": []
    }
  },
  "meta": { "generatedAt": "2026-10-25T13:20:00.000Z" }
}

Three kinds of value, never mixed

Every block says what it is with kind:

kindMeasured or predictedWhere
snotel_observationMeasuredAt the SNOTEL station (its hourly TOBS air temperature)
nws_observationMeasuredAt a nearby NWS station, named with its distance and elevation difference
nws_forecastPredicted by NWSFor the 2.5 km forecast grid cell the station sits in

A nearby NWS observation was not measured at the SNOTEL station. NWS stations in the mountains are usually tens of kilometres away and often hundreds of metres lower, so source.distanceKm and source.elevationDifferenceFt travel with every one. A forecast value is never offered as an observation.

Observed temperature

observed.primary is the temperature to show as "now", with where it came from:

  1. the SNOTEL station's own hourly air temperature, when one arrived within the last 180 minutes;
  2. otherwise the best-ranked nearby NWS station with a temperature in that window;
  3. otherwise null. A forecast never fills it.

observed.snotel and observed.nearby are always there for the full picture, stale or not. Nearby stations are ranked by distance plus elevation difference, within 80 km, and a station that had no recent observation with a temperature the last time Open SNOTEL read it is ranked after those that did. SNOTEL sites that NWS relays from another network are left out, since their data is already the station's own, and so are the air-quality monitors NWS lists among its stations.

Forecast

forecast is the newest forecast NWS issued for the grid cell, as stored:

  • issuedAt is NWS's issuance time, fetchedAt when Open SNOTEL first stored that issuance, and checkedAt our last successful read of the grid. Freshness is measured from checkedAt: a forecast NWS has not reissued is still current as long as we keep confirming it.
  • periods are NWS's 12-hour periods (Tonight, Sunday, ...) still ahead, with the high or low.
  • hourly is the next 48 hours from the gridpoint forecast.
  • snowfall, quantitativePrecipitation and snowLevel are amounts over NWS's own intervals, often six hours, for the forecast's whole span.

Forecast snowfall is NWS's prediction of new snow depth. It is not a prediction of the station's snow water equivalent, and nothing here converts one into the other.

forecast is null until the station has been placed in the NWS grid and a forecast stored.

Alerts

alerts.items are the NWS watches, warnings and advisories in effect at the station, most severe first. matchedBy says how: polygon when the alert is drawn around an area that contains the station, or forecast_zone / county_zone when it is issued for the station's zone. alerts.checkedAt is our last successful read of the state's alert feed, so an empty list with a fresh check means none are in effect, and an empty list with a stale or unknown check means we can't currently say.

Freshness and caching

Each part has a freshness with state (fresh, stale, or unknown when never read), asOf and staleAfterMinutes: 180 for observations and the forecast, 45 for alerts. Freshness is judged when the response is made, so a cached answer still says when it has gone stale.

Open SNOTEL reads NWS on a schedule: forecasts and nearby observations hourly, alerts every 15 minutes. Answers are cached for up to five minutes and refreshed as soon as a new read is stored. When NWS is unavailable, the last good answer stays, marked stale.

Units are US: degF, in, ft, mph, percent, and degree_(angle) for wind direction. A value of null means NWS reported nothing, never zero.