Endpoints

Five endpoints covering forecasts, current conditions, alerts, air quality, and allergy data.

Forecast

GET /v1/forecast/{h3}.json

Returns forecast periods and a 10-day daily forecast for the given H3 cell.

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

Cache TTL: 15 minutes

Example response

{
  "h3": "862a10747ffffff",
  "updated": "2026-04-12T14:00:00Z",
  "periods": [
    {
      "startTime": "2026-04-12T06:00:00-07:00",
      "endTime": "2026-04-12T18:00:00-07:00",
      "isDaytime": true,
      "temperature": 68,
      "temperatureUnit": "F",
      "humidity": 45,
      "precipitationProbability": 10,
      "windSpeed": "8 mph",
      "windDirection": "NW",
      "shortForecast": "Partly Cloudy"
    }
  ],
  "dailyPeriods": [
    {
      "date": "2026-04-12",
      "highTemperature": 68,
      "lowTemperature": 51,
      "temperatureUnit": "F",
      "shortForecast": "Partly Cloudy",
      "precipitationProbability": 10,
      "windSpeed": "8 mph",
      "windDirection": "NW",
      "windSummary": "NW 8 mph"
    }
  ],
  "sources": [
    { "name": "National Weather Service", "url": "https://weather.gov", "license": "public-domain" },
    { "name": "Open-Meteo GFS Forecast API", "url": "https://open-meteo.com/en/docs/gfs-api", "license": "CC-BY-4.0" }
  ]
}

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" }
  ]
}

Allergy

GET /v1/allergy/{h3}.json

Returns pollen category forecasts for supported H3 cells.

Parameter	Type	Description
`h3`	string	H3 resolution-6 cell index for a supported city

Cache TTL: 12 hours

Example response

{
  "h3": "862a10747ffffff",
  "updated": "2026-04-15T06:00:00Z",
  "periods": [
    {
      "time": "2026-04-15T12:00:00Z",
      "overallSeverity": "high",
      "overallSeverityLabel": "High",
      "allergens": [
        {
          "category": "tree",
          "name": "Tree pollen",
          "count": 120,
          "severity": "high",
          "severityLabel": "High"
        }
      ]
    }
  ],
  "sources": [
    {
      "name": "Ambee Pollen API",
      "url": "https://docs.ambeedata.com/apis/pollen",
      "license": "commercial"
    }
  ]
}

Next: H3 Cell Lookup →