# Quickstart

> Make a first request: the latest snow water equivalent and snow depth at a station with curl, the stations near a coordinate, a range of history, and connecting an MCP client.

The API is public and read-only and needs no key. Every example here is a real request against `https://opensnotel.com`.

## Read a station's latest snow

Ask for the newest daily snow water equivalent (`WTEQ`) and snow depth (`SNWD`) at Banner Summit, Idaho, whose [station triplet](https://opensnotel.com/docs/reference/station-ids.md) is `312:ID:SNTL`:

```bash
curl 'https://opensnotel.com/api/v1/stations/312:ID:SNTL/latest?elements=WTEQ,SNWD&duration=DAILY'
```

```json
{
  "station": "312:ID:SNTL",
  "data": [
    {
      "elementCode": "SNWD",
      "duration": "DAILY",
      "ordinal": 1,
      "heightDepthIn": null,
      "unit": "in",
      "observedAt": "2026-10-24T08:00:00.000Z",
      "localDate": "2026-10-24",
      "value": 0,
      "flag": "R",
      "qualityFlag": "V",
      "isProvisional": null,
      "sourceUpdatedAt": null,
      "newestObservedAt": "2026-10-24T08:00:00.000Z",
      "freshness": { "state": "fresh", "staleAfterMinutes": 4320 }
    },
    {
      "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": null,
      "newestObservedAt": "2026-10-24T08:00:00.000Z",
      "freshness": { "state": "fresh", "staleAfterMinutes": 4320 }
    }
  ],
  "meta": { "generatedAt": "2026-10-25T16:46:13.048Z" }
}
```

How to read it:

- `value` is in `unit`, here inches. A snow depth of `0` is a measurement of bare ground. A reading the source did not report is `null`, never `0`.
- `localDate` is the station's own calendar day; `observedAt` is the UTC instant that day starts at the station's fixed offset (UTC−8 here). See [time and dates](https://opensnotel.com/docs/reference/time.md).
- `freshness.state` `fresh` means recent data is reaching Snotel. It says nothing about whether snow changed. See [freshness](https://opensnotel.com/docs/data/freshness.md).
- `flag` `R` (raw) and `qualityFlag` `V` (valid) are the source's own letters. See [quality](https://opensnotel.com/docs/data/quality.md).

## Find the stations near a point

`lat` and `lng` are decimal degrees, latitude first:

```bash
curl 'https://opensnotel.com/api/v1/stations/nearest?lat=44.31&lng=-115.2&limit=3'
```

Each result has the station's `id` (its triplet) and `distanceKm`, a straight-line distance. The nearest station is not necessarily on the same slope or at the same elevation as your point. See [nearest stations](https://opensnotel.com/docs/api/nearest.md).

## Read a range of history

Readings between two of the station's local dates, inclusive, up to 366 days of daily data per request:

```bash
curl 'https://opensnotel.com/api/v1/stations/312:ID:SNTL/observations?elements=WTEQ,SNWD&from=2025-10-01&to=2026-04-30'
```

For more than one request returns, ask for consecutive ranges. There is no bulk download of observation history. See [observations](https://opensnotel.com/docs/api/observations.md).

## Connect an agent

The MCP server exposes the same data as tools. With Claude Code:

```bash
claude mcp add --transport http snotel https://opensnotel.com/mcp
```

Any other client takes the URL `https://opensnotel.com/mcp` and the Streamable HTTP transport. See [connect](https://opensnotel.com/docs/mcp/connect.md).

## Before you build on it

- Snow water equivalent, not snow depth, says how much water the snowpack holds; see [measurements](https://opensnotel.com/docs/data/measurements.md).
- A rise in snow depth is not the amount of snow that fell; see [provenance](https://opensnotel.com/docs/data/provenance.md#a-depth-change-is-not-snowfall).
- Store a station as its triplet, whole; see [station IDs](https://opensnotel.com/docs/reference/station-ids.md).
- Every value keeps the source's unit. Snotel converts nothing.

## Next

- [Overview](https://opensnotel.com/docs/api.md): Use the REST API at /api/v1: every endpoint, the conventions all responses follow (UTC times, null for missing, the source's units and flags), request bounds and caching.
- [Connect](https://opensnotel.com/docs/mcp/connect.md): Connect an MCP client to https://opensnotel.com/mcp: the URL, the Streamable HTTP transport, a Claude Code command, a JSON config, and how to check the connection.

Canonical page: https://opensnotel.com/docs/quickstart
