The stations endpoints list stations and return one by its triplet. A station is identified by its station triplet and nothing else.
List stations
GET /api/v1/stations returns a page of stations ordered stably, so paging never repeats or skips one.
| Parameter | Meaning |
|---|---|
q | Part of the station name, case-insensitive, 2 to 100 characters. |
state | Two-letter state code, such as ID. |
network | Network code, such as SNTL. |
active | true for active stations only, false for inactive only. |
provider | Which provider's stations to list, by code. Default nrcs. |
limit | Stations per page, 1 to 500. Default 100. |
cursor | The page.nextCursor of the previous page. |
curl 'https://opensnotel.com/api/v1/stations?state=ID&q=banner&limit=1'
{
"data": [
{
"id": "312:ID:SNTL",
"name": "Banner Summit",
"stateCode": "ID",
"networkCode": "SNTL",
"latitude": 44.30342,
"longitude": -115.23447,
"elevationFt": 7040,
"utcOffsetMinutes": -480,
"isActive": true,
"periodOfRecord": { "start": "1979-10-01", "end": null }
}
],
"page": { "limit": 1, "nextCursor": null },
"meta": { "generatedAt": "2026-10-23T21:20:00.000Z" }
}
page.nextCursor is null on the last page. A cursor is opaque: hand it back as cursor and do not parse it. A cursor the API did not issue is an invalid_parameter error.
Get one station
GET /api/v1/stations/{station} returns the station and the measurements it reports, so you can see which elements to ask for before asking.
curl 'https://opensnotel.com/api/v1/stations/312:ID:SNTL'
{
"data": {
"id": "312:ID:SNTL",
"name": "Banner Summit",
"stateCode": "ID",
"networkCode": "SNTL",
"latitude": 44.30342,
"longitude": -115.23447,
"elevationFt": 7040,
"utcOffsetMinutes": -480,
"isActive": true,
"periodOfRecord": { "start": "1979-10-01", "end": null },
"elements": [
{
"elementCode": "SNWD",
"duration": "DAILY",
"ordinal": 1,
"heightDepthIn": null,
"unit": "in",
"isDerived": false,
"isAvailable": true,
"periodOfRecord": { "start": "2000-08-23", "end": null }
}
],
"missingData": []
},
"meta": { "generatedAt": "2026-10-23T21:20:00.000Z" }
}
Fields
-
idis the station triplet.stateCodeandnetworkCodeare its parts. -
publicIdis the station's id across providers. For an NRCS station it is the triplet, the same asid; another provider's station is<provider>:<provider station id>. See station IDs. -
sourcesays who publishes the station's data and how to credit it; see source below. -
latitude,longitudeandelevationFtarenullwhen the source's value is missing or out of range. -
utcOffsetMinutesis the fixed offset of the station's local standard time; there is no daylight saving. See time and dates. -
isActiveisnullwhen the source does not say. A station that stopped reporting is still listed, with the end of itsperiodOfRecord. -
Each element is one sensor:
ordinaltells several sensors of one element apart, andheightDepthInis a sensor's height (positive) or depth (negative) in inches.isAvailableisfalseonce the source stopped listing it; its history remains.periodOfRecordis the span with data, so a sensor can have fewer readings than days in it. Measurements defines the element codes. -
missingDatalists elements the source can't serve for this station, with the first missing local date (from) and thereason, oldest first. Those readings are absent from observations, never filled in. It is[]for nearly every station. The service always sends it, but it was added after v1, so treat an absent list as empty. Each entry'ssourcesays where it came from:curated: listed by hand. It is open-ended (noto) and covers every duration; Open SNOTEL doesn't read the element fromfromon.automatic: ingest found the source answering an error (HTTP 500) for the element even when asked for it alone. It is bounded byto, the last missing local date, and names the oneduration(DAILYorHOURLY) it covers. Open SNOTEL keeps asking for the element: recent dates are asked for again on the next scheduled read, and the entry shrinks or goes once the source serves them. Older dates, recorded by a backfill, stay listed until a backfill reads them again.
to,durationandsourcewere added later and are optional: an entry withoutsourceiscurated.
Source
Every station carries where its data comes from, taken from the data sources registry:
{
"publicId": "312:ID:SNTL",
"source": {
"provider": "nrcs",
"feed": "awdb",
"name": "USDA Natural Resources Conservation Service — AWDB REST API",
"network": "SNTL",
"countryCode": "US",
"region": "ID",
"attribution": "USDA Natural Resources Conservation Service, National Water and Climate Center",
"licenseStatus": "pending",
"license": null,
"licenseUrl": null
}
}
providerandfeedare the registry's codes;namespells them out.networkis the provider's own network for the station, andregionits own region code: a US state for NRCS, not necessarily a state elsewhere.countryCodeis ISO 3166-1 alpha-2, ornullwhen a provider spans countries and does not say.attributionis the credit line to show wherever the station's data is shown.licenseStatusisverifiedonce a person has checked the provider's terms andpendinguntil then;licenseandlicenseUrlname the licence when one is recorded.
publicId and source were added after v1. The service always sends them, but treat them as optional.
Lists and searches cover one provider at a time. Without provider that is nrcs, so another provider's stations never appear in a default list; ask for them by code.
An unknown station answers 404 with station_not_found; an id that is not a triplet answers 400. See errors.