Endpoints

Four endpoints covering forecasts, current conditions, alerts, and air quality.

Forecast

GET /v1/forecast/{h3}.json

Returns a 48-hour hourly forecast for the given H3 cell.

Parameter	Type	Description
`h3`	string	H3 resolution-6 cell index

Cache TTL: 15 minutes

Example response

{
  "h3": "862a10747ffffff",
  "generatedAt": "2026-04-12T14:00:00Z",
  "hourly": [
    {
      "time": "2026-04-12T15:00:00Z",
      "tempF": 68,
      "feelsLikeF": 66,
      "humidity": 45,
      "precipProbability": 10,
      "windSpeedMph": 8,
      "windDirection": "NW",
      "condition": "Partly Cloudy",
      "icon": "partly-cloudy"
    }
  ],
  "sources": [
    { "name": "NWS", "url": "https://www.weather.gov", "license": "Public Domain" }
  ]
}

Current Conditions

GET /v1/current/{h3}.json

Returns the latest observations for the given H3 cell, sourced from the nearest METAR station.

Parameter	Type	Description
`h3`	string	H3 resolution-6 cell index

Cache TTL: 15 minutes

Example response

{
  "h3": "862a10747ffffff",
  "observedAt": "2026-04-12T13:53:00Z",
  "station": "KSEA",
  "tempF": 67,
  "feelsLikeF": 65,
  "humidity": 48,
  "windSpeedMph": 6,
  "windDirection": "S",
  "condition": "Fair",
  "icon": "clear-day",
  "sources": [
    { "name": "NWS", "url": "https://www.weather.gov", "license": "Public Domain" }
  ]
}

Alerts

GET /v1/alerts/{zone}.json

Returns active NWS weather alerts for the given forecast zone.

Parameter	Type	Description
`zone`	string	NWS forecast zone ID (e.g., `WAZ558`)

Cache TTL: 1 minute

Example response

{
  "zone": "WAZ558",
  "alerts": [
    {
      "event": "Wind Advisory",
      "severity": "moderate",
      "headline": "Wind Advisory until 10 PM PDT",
      "description": "South winds 25 to 35 mph with gusts up to 50 mph.",
      "onset": "2026-04-12T12:00:00-07:00",
      "expires": "2026-04-12T22:00:00-07:00"
    }
  ],
  "sources": [
    { "name": "NWS", "url": "https://www.weather.gov", "license": "Public Domain" }
  ]
}

Air Quality

GET /v1/air/{h3}.json

Returns the current air quality index for the given H3 cell, sourced from AirNow.

Parameter	Type	Description
`h3`	string	H3 resolution-6 cell index

Cache TTL: 15 minutes

Example response

{
  "h3": "862a10747ffffff",
  "observedAt": "2026-04-12T13:00:00Z",
  "aqi": 42,
  "category": "Good",
  "primaryPollutant": "PM2.5",
  "sources": [
    { "name": "AirNow", "url": "https://www.airnow.gov", "license": "Public Domain" }
  ]
}

Next: H3 Cell Lookup →