ClimatePulse Event Weather Brief

{
  "type": "json",
  "errors": {
    "400": {
      "example": {
        "error": "location parameter required"
      },
      "description": "Invalid or missing parameter(s) — required: location, date. Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."
    },
    "402": {
      "description": "Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."
    },
    "500": {
      "example": {
        "error": "upstream_failed"
      },
      "description": "Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."
    }
  },
  "example": {
    "sources": [
      {
        "source": "MET Norway (Norwegian Meteorological Institute)",
        "licence": "CC BY 4.0"
      },
      {
        "source": "NASA POWER (MERRA-2 / GEOS reanalysis)"
      }
    ],
    "location": "Napa, CA, United States",
    "disclaimer": "Historical odds are climatology, not a forecast. Recheck at each decision point.",
    "event_date": "2026-09-15",
    "event_type": "wedding",
    "live_forecast": {
      "reason": "event is 65 days out — beyond the 10-day forecast window; climatology only",
      "available": false
    },
    "risk_assessment": {
      "cold": "low",
      "heat": "moderate",
      "rain": "low",
      "wind": "low",
      "overall": "moderate"
    },
    "contingency_plan": [
      "Book shade structures now",
      "Schedule ceremony after 5pm"
    ],
    "headline_verdict": "A historically dry, warm date — plan for afternoon heat, not rain.",
    "historical_stats": {
      "temps": {
        "p10_high": 75.2,
        "p90_high": 93.4,
        "record_low": 45.9,
        "average_low": 52.3,
        "record_high": 101.8,
        "average_high": 84.1
      },
      "data_source": "NASA POWER daily reanalysis (MERRA-2/GEOS) — 10 years, ±3-day window, 70 sampled days",
      "unavailable": [
        "thunderstorm probability — NASA POWER publishes no weather code, so thunder days are unmeasured (not zero)"
      ],
      "probabilities_pct": {
        "frost": 0,
        "windy": 4,
        "hot_day": 27,
        "any_rain": 6,
        "extreme_heat": 3,
        "thunderstorm": null,
        "significant_rain": 1
      },
      "exact_date_by_year": [
        {
          "low": 54.1,
          "high": 88.2,
          "year": 2025,
          "conditions": null,
          "precipitation": 0
        }
      ]
    },
    "decision_timeline": {
      "decision_points": [
        {
          "date": "2026-09-05",
          "milestone": "10-day forecast window opens — first model signal, low confidence",
          "days_before_event": 10
        }
      ],
      "forecast_status": "beyond_forecast_range",
      "days_until_event": 65
    }
  }
}