---
title: "NWS radar station catalog"
method: GET
path: "/api/v1/weather/nws/radar/stations"
tags: ["Environment"]
---

# NWS radar station catalog

`GET /api/v1/weather/nws/radar/stations`

Return the catalog of NWS radar stations (approximately 208 sites). The US operates a WSR-88D (NEXRAD) network of around 160 S-band Doppler radars plus TDWR terminal Doppler radars at major airports. Each record carries the station ID, name, latitude, longitude, elevation, current and average operational latency. Sugra surfaces the catalog for discovery and situational-awareness; radar Level-II / Level-III volume data itself is served by separate NOAA infrastructure not integrated here. Attribution: NOAA National Weather Service (api.weather.gov).

## Response `200`

List of radar stations with live-latency metadata.

- EnvelopeNwsRadarStationsPayload
  - `data` NwsRadarStationsPayload, required — Radar station catalog response.
    - `count` integer, required — Number of radar stations returned.
    - `stations` NwsRadarStation[], required — Radar station records.
      - `id` string, nullable — Radar station ID (e.g. `KLWX`).
      - `name` string, nullable — Radar station name.
      - `station_type` string, nullable — Station type: `WSR-88D`, `TDWR`.
      - `latitude` number, nullable — Station latitude.
      - `longitude` number, nullable — Station longitude.
      - `elevation_m` number, nullable — Station elevation in metres.
      - `time_zone` string, nullable — IANA time zone identifier.
      - `latency_current_value` number, nullable — Current operational latency value.
      - `latency_current_unit` string, nullable — Unit symbol for the current latency.
      - `latency_average_value` number, nullable — Rolling average latency value.
      - `latency_average_unit` string, nullable — Unit symbol for the average latency.
  - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope.
    - `endpoint` string, required — Requested endpoint path.
    - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request.
    - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced.
    - `provider` string, required — API name and version.
    - `source` string, nullable — Identifier of the primary upstream source used for this response.
    - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response.
    - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data.
    - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried.
    - `cached` boolean, nullable — True when this response was served from the internal cache.
    - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data.

## Other responses

- `401` — Missing or invalid `x-api-key` header.
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

[API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/revisions/dcf7427e6897/schema)
