Platform data-freshness status.

Returns the current data-freshness status of the weather platform: an overall state, per-source states, open incidents, and any active provider advisories.

Every source is continuously evaluated against its expected publication cadence across the ingestion, processing, and serving stages. States:

ok — data is flowing within its expected cadence.
degraded — data is staler than expected but below outage thresholds.
outage — data has been stale long enough to be considered an outage. The incident.cause field attributes it (e.g. provider_outage vs processing_delay).
no_signal — the monitor has no signal for this source (instrumentation gap, not necessarily a data gap).

The document regenerates about every 5 minutes; responses carry Cache-Control: public, max-age=60. This endpoint does not require authentication, so it stays reachable during the incidents it describes — agents and integrations should consult it before reporting weather data as current, and may relay advisories entries to end users.

get/v1/status

Request

Base URL: https://api.smarterweather.com
URL: https://api.smarterweather.com/v1/status
Auth: none required

Response

Current platform status document.

versioninteger required

Document schema version.

generated_atstring date-time required

When this document was generated (UTC).

overall'ok' | 'degraded' | 'outage' | 'no_signal' required

Worst state across customer-facing sources. ok means all customer-facing weather data is flowing within its expected cadence.

Example response

{
  "version": 1,
  "sources": [
    {
      "source_id": "goes",
      "name": "GOES ABI Satellite Imagery",
      "provider_id": "noaa",
      "incident": {
        "cause": "provider_outage"
      }
    }
  ],
  "advisories": [
    {
      "provider_id": "noaa"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.