---
title: "GET /zones/forecast/{zoneId}/observations"
method: GET
path: "/zones/forecast/{zoneId}/observations"
---

# GET /zones/forecast/{zoneId}/observations

`GET /zones/forecast/{zoneId}/observations`

## Request

- Base URL: `https://api.weather.gov`
- URL: `https://api.weather.gov/zones/forecast/{zoneId}/observations`
- Auth: one of:
  - API key in header `User-Agent`
  - API key in header `API-Key`

Returns a list of observations for a given zone

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `limit` integer

## Response `200`

success

- ObservationCollectionGeoJson: A GeoJSON feature collection. Please refer to IETF RFC 7946 for information on the GeoJSON format.
  - `@context` union
    - unknown[]
      - unknown
    - object
  - `type` 'FeatureCollection', required
  - `features` object[], required
    - `@context` union
      - unknown[]
        - unknown
      - object
    - `id` string, uri
    - `type` 'Feature', required
    - `geometry` union, required: A GeoJSON geometry object. Please refer to IETF RFC 7946 for information on the GeoJSON format.
      - object
        - `type` 'Point', required
        - `coordinates` number[], required: A GeoJSON coordinate. Please refer to IETF RFC 7946 for information on the GeoJSON format.
        - `bbox` number[]: A GeoJSON bounding box. Please refer to IETF RFC 7946 for information on the GeoJSON format.
      - object
        - `type` 'LineString', required
        - `coordinates` GeoJsonCoordinate[], required: A GeoJSON line string. Please refer to IETF RFC 7946 for information on the GeoJSON format.
          - number[]: A GeoJSON coordinate. Please refer to IETF RFC 7946 for information on the GeoJSON format.
        - `bbox` number[]: A GeoJSON bounding box. Please refer to IETF RFC 7946 for information on the GeoJSON format.
      - object
        - `type` 'Polygon', required
        - `coordinates` array[], required: A GeoJSON polygon. Please refer to IETF RFC 7946 for information on the GeoJSON format.
          - GeoJsonCoordinate[]
            - number[]: A GeoJSON coordinate. Please refer to IETF RFC 7946 for information on the GeoJSON format.
        - `bbox` number[]: A GeoJSON bounding box. Please refer to IETF RFC 7946 for information on the GeoJSON format.
      - object
        - `type` 'MultiPoint', required
        - `coordinates` GeoJsonCoordinate[], required
          - number[]: A GeoJSON coordinate. Please refer to IETF RFC 7946 for information on the GeoJSON format.
        - `bbox` number[]: A GeoJSON bounding box. Please refer to IETF RFC 7946 for information on the GeoJSON format.
      - object
        - `type` 'MultiLineString', required
        - `coordinates` GeoJsonLineString[], required
          - GeoJsonCoordinate[]: A GeoJSON line string. Please refer to IETF RFC 7946 for information on the GeoJSON format.
            - number[]: A GeoJSON coordinate. Please refer to IETF RFC 7946 for information on the GeoJSON format.
        - `bbox` number[]: A GeoJSON bounding box. Please refer to IETF RFC 7946 for information on the GeoJSON format.
      - object
        - `type` 'MultiPolygon', required
        - `coordinates` GeoJsonPolygon[], required
          - array[]: A GeoJSON polygon. Please refer to IETF RFC 7946 for information on the GeoJSON format.
            - GeoJsonCoordinate[]
              - …
        - `bbox` number[]: A GeoJSON bounding box. Please refer to IETF RFC 7946 for information on the GeoJSON format.
    - `properties` object, required
      - `@context` union
        - unknown[]
          - unknown
        - object
      - `geometry` string, wkt, nullable: A geometry represented in Well-Known Text (WKT) format.
      - `@id` string, uri
      - `@type` 'wx:ObservationStation'
      - `elevation` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `station` string, uri
      - `stationId` string
      - `stationName` string
      - `timestamp` string, date-time
      - `rawMessage` string
      - `textDescription` string
      - `icon` string, uri, nullable
      - `presentWeather` MetarPhenomenon[]
        - `intensity` 'light' | 'heavy', nullable, required
        - `modifier` 'patches' | 'blowing' | 'low_drifting' | 'freezing' | 'shallow' | 'partial' | 'showers', nullable, required
        - `weather` 'fog_mist' | 'dust_storm' | 'dust' | 'drizzle' | 'funnel_cloud' | 'fog' | 'smoke' | 'hail' | 'snow_pellets' | 'haze' | 'ice_crystals' | 'ice_pellets' | 'dust_whirls' | 'spray' | 'rain' | 'sand' | 'snow_grains' | 'snow' | 'squalls' | 'sand_storm' | 'thunderstorms' | 'unknown' | 'volcanic_ash', required
        - `rawString` string, required
        - `inVicinity` boolean
      - `temperature` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `dewpoint` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `windDirection` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `windSpeed` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `windGust` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `barometricPressure` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `seaLevelPressure` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `visibility` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `maxTemperatureLast24Hours` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `minTemperatureLast24Hours` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `precipitationLastHour` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `precipitationLast3Hours` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `precipitationLast6Hours` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `relativeHumidity` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `windChill` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `heatIndex` QuantitativeValue: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
        - `value` number, nullable: A measured value
        - `maxValue` number: The maximum value of a range of measured values
        - `minValue` number: The minimum value of a range of measured values
        - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
        - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
      - `cloudLayers` object[], nullable
        - `base` QuantitativeValue, required: A structured value representing a measurement and its unit of measure. This object is a slightly modified version of the schema.org definition at https://schema.org/QuantitativeValue
          - `value` number, nullable: A measured value
          - `maxValue` number: The maximum value of a range of measured values
          - `minValue` number: The minimum value of a range of measured values
          - `unitCode` string: A string denoting a unit of measure, expressed in the format "{unit}" or "{namespace}:{unit}". Units with the namespace "wmo" or "wmoUnit" are defined in the World Meteorological Organization Codes Registry at http://codes.wmo.int/common/unit and should be canonically resolvable to http://codes.wmo.int/common/unit/{unit}. Units with the namespace "nwsUnit" are currently custom and do not align to any standard. Units with no namespace or the namespace "uc" are compliant with the Unified Code for Units of Measure syntax defined at https://unitsofmeasure.org/. This also aligns with recent versions of the Geographic Markup Language (GML) standard, the IWXXM standard, and OGC Observations and Measurements v2.0 (ISO/DIS 19156). Namespaced units are considered deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.
          - `qualityControl` 'Z' | 'C' | 'S' | 'V' | 'X' | 'Q' | 'G' | 'B' | 'T': For values in observation records, the quality control flag from the MADIS system. The definitions of these flags can be found at https://madis.ncep.noaa.gov/madis_sfc_qc_notes.shtml
        - `amount` 'OVC' | 'BKN' | 'SCT' | 'FEW' | 'SKC' | 'CLR' | 'VV', required
  - `pagination` PaginationInfo: Links for retrieving more data from paged data sets
    - `next` string, uri, required: A link to the next page of records

## Other responses

- `default`: An error response.

## Changes

- **2026-07-13** `941dbd15eabe`: 1 breaking, 6 info
  - added `subschema #7` to the `allOf[#/components/schemas/GeoJsonFeatureCollection]/features/items/geometry` response property `oneOf` list for the response status `200` (media type: application/geo+json)
  - added the optional property `@graph/items/stationId` to the response with the `200` status (media type: application/ld+json)
  - added the optional property `@graph/items/stationName` to the response with the `200` status (media type: application/ld+json)
  - added the optional property `allOf[subschema #2]/features/items/properties/stationId` to the response with the `200` status (media type: application/geo+json)
  - …3 more

[Operation history](https://skmtc.dev/weather/apis/weather-gov-api/changes/zones/forecast/:zoneId/observations/get.md)

---

[API](https://skmtc.dev/weather/apis/weather-gov-api.md) - [All operations](https://skmtc.dev/weather/apis/weather-gov-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weather/apis/weather-gov-api/revisions/ed43606f373e?raw)
