openapi: 3.1.2
info:
  title: weather.gov API
  description: weather.gov API
  version: 3.8.1
  x-last-validated: '2026-05-03'
servers:
- url: https://api.weather.gov
  description: Production server
paths:
  /alerts:
    get:
      description: Returns all alerts
      operationId: alerts_query
      parameters:
      - name: active
        in: query
        description: List only active alerts (use /alerts/active endpoints instead)
        deprecated: true
        schema:
          type: boolean
        example: true
      - $ref: '#/components/parameters/QueryStartTime'
        example: example-value
      - $ref: '#/components/parameters/QueryEndTime'
        example: example-value
      - $ref: '#/components/parameters/AlertStatus'
        example: example-value
      - $ref: '#/components/parameters/AlertMessageType'
        example: example-value
      - $ref: '#/components/parameters/AlertEventName'
        example: example-value
      - $ref: '#/components/parameters/AlertCode'
        example: example-value
      - $ref: '#/components/parameters/AlertArea'
        example: example-value
      - $ref: '#/components/parameters/AlertPoint'
        example: example-value
      - $ref: '#/components/parameters/AlertRegion'
        example: example-value
      - $ref: '#/components/parameters/AlertRegionType'
        example: example-value
      - $ref: '#/components/parameters/AlertZone'
        example: example-value
      - $ref: '#/components/parameters/AlertUrgency'
        example: example-value
      - $ref: '#/components/parameters/AlertSeverity'
        example: example-value
      - $ref: '#/components/parameters/AlertCertainty'
        example: example-value
      - $ref: '#/components/parameters/Limit'
        example: example-value
      - $ref: '#/components/parameters/PaginationCursor'
        example: example-value
      responses:
        '200':
          $ref: '#/components/responses/AlertCollection'
        '301':
          description: Certain common queries may be redirected to discrete URLs
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns All Alerts
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /alerts/active:
    get:
      description: Returns all currently active alerts
      operationId: alerts_active
      parameters:
      - $ref: '#/components/parameters/AlertStatus'
        example: example-value
      - $ref: '#/components/parameters/AlertMessageType'
        example: example-value
      - $ref: '#/components/parameters/AlertEventName'
        example: example-value
      - $ref: '#/components/parameters/AlertCode'
        example: example-value
      - $ref: '#/components/parameters/AlertArea'
        example: example-value
      - $ref: '#/components/parameters/AlertPoint'
        example: example-value
      - $ref: '#/components/parameters/AlertRegion'
        example: example-value
      - $ref: '#/components/parameters/AlertRegionType'
        example: example-value
      - $ref: '#/components/parameters/AlertZone'
        example: example-value
      - $ref: '#/components/parameters/AlertUrgency'
        example: example-value
      - $ref: '#/components/parameters/AlertSeverity'
        example: example-value
      - $ref: '#/components/parameters/AlertCertainty'
        example: example-value
      responses:
        '200':
          $ref: '#/components/responses/AlertCollection'
        '301':
          description: Certain common queries may be redirected to discrete URLs
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns All Currently Active Alerts
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /alerts/active/count:
    get:
      description: Returns info on the number of active alerts
      operationId: alerts_active_count
      responses:
        '200':
          description: A data structure showing the counts of active alerts broken down by various categories
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                type: object
                properties:
                  total:
                    minimum: 0
                    type: integer
                    description: The total number of active alerts
                  land:
                    minimum: 0
                    type: integer
                    description: The total number of active alerts affecting land zones
                  marine:
                    minimum: 0
                    type: integer
                    description: The total number of active alerts affecting marine zones
                  regions:
                    type: object
                    description: Active alerts by marine region
                    additionalProperties:
                      minimum: 1
                      type: integer
                  areas:
                    type: object
                    description: Active alerts by area (state/territory)
                    additionalProperties:
                      minimum: 1
                      type: integer
                  zones:
                    type: object
                    description: Active alerts by NWS public zone or county code
                    additionalProperties:
                      minimum: 1
                      type: integer
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Info on the Number of Active Alerts
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /alerts/active/zone/{zoneId}:
    get:
      description: Returns active alerts for the given NWS public zone or county
      operationId: alerts_active_zone
      responses:
        '200':
          $ref: '#/components/responses/AlertCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Active Alerts for the Given NWS Public Zone or County
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSZoneId'
  /alerts/active/area/{area}:
    get:
      description: Returns active alerts for the given area (state or marine area)
      operationId: alerts_active_area
      responses:
        '200':
          $ref: '#/components/responses/AlertCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Active Alerts for the Given Area (state or Marine Area)
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: area
      in: path
      description: State/area ID
      required: true
      schema:
        $ref: '#/components/schemas/AreaCode'
  /alerts/active/region/{region}:
    get:
      description: Returns active alerts for the given marine region
      operationId: alerts_active_region
      responses:
        '200':
          $ref: '#/components/responses/AlertCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Active Alerts for the Given Marine Region
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: region
      in: path
      description: Marine region ID
      required: true
      schema:
        $ref: '#/components/schemas/MarineRegionCode'
  /alerts/types:
    get:
      description: Returns a list of alert types
      operationId: alerts_types
      responses:
        '200':
          description: A list of recognized event types
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                type: object
                properties:
                  eventTypes:
                    type: array
                    items:
                      type: string
                    description: A list of recognized event types
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Alert Types
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /alerts/{id}:
    get:
      description: Returns a specific alert
      operationId: alerts_single
      responses:
        '200':
          description: An alert record
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/AlertGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/AlertJsonLd'
            application/cap+xml:
              schema:
                $ref: '#/components/schemas/AlertCap'
          x-url-content-negotiation-extensions:
            json: application/geo+json
            cap: application/cap+xml
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a Specific Alert
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: id
      in: path
      description: Alert identifier
      required: true
      schema:
        $ref: '#/components/schemas/AlertId'
  /aviation/cwsus/{cwsuId}:
    get:
      description: Returns metadata about a Center Weather Service Unit
      operationId: cwsu
      parameters:
      - $ref: '#/components/parameters/NWSCenterWeatherServiceUnitId'
        example: example-value
      responses:
        '200':
          description: success
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/CenterWeatherServiceUnitJsonLd'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Metadata About a Center Weather Service Unit
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /aviation/cwsus/{cwsuId}/cwas:
    get:
      description: Returns a list of Center Weather Advisories from a CWSU
      operationId: cwas
      parameters:
      - $ref: '#/components/parameters/NWSCenterWeatherServiceUnitId'
        example: example-value
      responses:
        '200':
          description: success
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/CenterWeatherAdvisoryCollectionGeoJson'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Center Weather Advisories from a CWSU
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /aviation/cwsus/{cwsuId}/cwas/{date}/{sequence}:
    get:
      description: Returns a list of Center Weather Advisories from a CWSU
      operationId: cwa
      parameters:
      - $ref: '#/components/parameters/NWSCenterWeatherServiceUnitId'
        example: example-value
      - $ref: '#/components/parameters/Date'
        example: example-value
      - name: sequence
        in: path
        description: Sequence number
        required: true
        schema:
          minimum: 100
          type: integer
        example: 100
      responses:
        '200':
          description: success
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/CenterWeatherAdvisoryGeoJson'
            application/vnd.noaa.uswx+xml:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Center Weather Advisories from a CWSU
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /aviation/sigmets:
    get:
      description: Returns a list of SIGMET/AIRMETs
      operationId: sigmetQuery
      parameters:
      - $ref: '#/components/parameters/QueryStartTime'
        example: example-value
      - $ref: '#/components/parameters/QueryEndTime'
        example: example-value
      - $ref: '#/components/parameters/QueryDate'
        example: example-value
      - name: atsu
        in: query
        description: ATSU identifier
        schema:
          $ref: '#/components/schemas/ATSUIdentifier'
      - name: sequence
        in: query
        description: SIGMET sequence number
        schema:
          $ref: '#/components/schemas/SigmetSequenceNumber'
      responses:
        '200':
          description: success
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/SigmetCollectionGeoJson'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of SIGMET/AIRMETs
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /aviation/sigmets/{atsu}:
    get:
      description: Returns a list of SIGMET/AIRMETs for the specified ATSU
      operationId: sigmetsByATSU
      parameters:
      - $ref: '#/components/parameters/ATSUIdentifier'
        example: example-value
      responses:
        '200':
          description: success
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/SigmetCollectionGeoJson'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of SIGMET/AIRMETs for the Specified ATSU
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /aviation/sigmets/{atsu}/{date}:
    get:
      description: Returns a list of SIGMET/AIRMETs for the specified ATSU for the specified date
      operationId: sigmetsByATSUByDate
      parameters:
      - $ref: '#/components/parameters/ATSUIdentifier'
        example: example-value
      - $ref: '#/components/parameters/Date'
        example: example-value
      responses:
        '200':
          description: success
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/SigmetCollectionGeoJson'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of SIGMET/AIRMETs for the Specified ATSU for the Specified Date
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /aviation/sigmets/{atsu}/{date}/{time}:
    get:
      description: Returns a specific SIGMET/AIRMET
      operationId: sigmet
      parameters:
      - $ref: '#/components/parameters/ATSUIdentifier'
        example: example-value
      - $ref: '#/components/parameters/Date'
        example: example-value
      - $ref: '#/components/parameters/Time'
        example: example-value
      responses:
        '200':
          description: success
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/SigmetGeoJson'
            application/vnd.noaa.uswx+xml:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a Specific SIGMET/AIRMET
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /glossary:
    get:
      description: Returns glossary terms
      operationId: glossary
      responses:
        '200':
          description: A set of glossary terms
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                type: object
                properties:
                  '@context':
                    $ref: '#/components/schemas/JsonLdContext'
                  glossary:
                    type: array
                    items:
                      type: object
                      properties:
                        term:
                          type: string
                          description: The term being defined
                        definition:
                          type: string
                          description: A definition for the term
                    description: A list of glossary terms
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Glossary Terms
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /gridpoints/{wfo}/{x},{y}:
    get:
      description: Returns raw numerical forecast data for a 2.5km grid area
      operationId: gridpoint
      parameters: []
      responses:
        '200':
          description: Gridpoint forecast data
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/GridpointGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/GridpointJsonLd'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Raw Numerical Forecast Data for a 2.5km Grid Area
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/GridpointWFO'
    - $ref: '#/components/parameters/GridpointX'
    - $ref: '#/components/parameters/GridpointY'
  /gridpoints/{wfo}/{x},{y}/forecast:
    get:
      description: Returns a textual forecast for a 2.5km grid area
      operationId: gridpoint_forecast
      parameters:
      - $ref: '#/components/parameters/GridpointForecastFeatureFlags'
        example: example-value
      - $ref: '#/components/parameters/GridpointForecastUnits'
        example: example-value
      responses:
        '200':
          $ref: '#/components/responses/Gridpoint12hForecast'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a Textual Forecast for a 2.5km Grid Area
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/GridpointWFO'
    - $ref: '#/components/parameters/GridpointX'
    - $ref: '#/components/parameters/GridpointY'
  /gridpoints/{wfo}/{x},{y}/forecast/hourly:
    get:
      description: Returns a textual hourly forecast for a 2.5km grid area
      operationId: gridpoint_forecast_hourly
      parameters:
      - $ref: '#/components/parameters/GridpointForecastFeatureFlags'
        example: example-value
      - $ref: '#/components/parameters/GridpointForecastUnits'
        example: example-value
      responses:
        '200':
          $ref: '#/components/responses/GridpointHourlyForecast'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a Textual Hourly Forecast for a 2.5km Grid Area
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/GridpointWFO'
    - $ref: '#/components/parameters/GridpointX'
    - $ref: '#/components/parameters/GridpointY'
  /gridpoints/{wfo}/{x},{y}/stations:
    get:
      description: Returns a list of observation stations usable for a given 2.5km grid area
      operationId: gridpoint_stations
      responses:
        '200':
          $ref: '#/components/responses/ObservationStationCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Observation Stations Usable for a Given 2.5km Grid Area
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/GridpointWFO'
    - $ref: '#/components/parameters/GridpointX'
    - $ref: '#/components/parameters/GridpointY'
    - $ref: '#/components/parameters/Limit'
  /icons/{set}/{timeOfDay}/{first}:
    get:
      description: Returns a forecast icon. Icon services in API are deprecated.
      operationId: icons
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            image/png:
              schema:
                $ref: '#/components/schemas/BinaryFile'
        default:
          $ref: '#/components/responses/Error'
      deprecated: true
      parameters: []
      summary: Weather.gov Returns a Forecast Icon. Icon Services in API Are Deprecated.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: set
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: timeOfDay
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: first
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: size
      in: query
      description: Font size
      schema:
        anyOf:
        - enum:
          - small
          - medium
          - large
          type: string
        - maximum: 500
          minimum: 10
          type: integer
    - name: fontsize
      in: query
      description: Font size
      schema:
        maximum: 24
        minimum: 2
        type: integer
  /icons/{set}/{timeOfDay}/{first}/{second}:
    get:
      description: Returns a forecast icon. Icon services in API are deprecated.
      operationId: iconsDualCondition
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            image/png:
              schema:
                $ref: '#/components/schemas/BinaryFile'
        default:
          $ref: '#/components/responses/Error'
      deprecated: true
      parameters: []
      summary: Weather.gov Returns a Forecast Icon. Icon Services in API Are Deprecated.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: set
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: timeOfDay
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: first
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: second
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: size
      in: query
      description: Font size
      schema:
        anyOf:
        - enum:
          - small
          - medium
          - large
          type: string
        - maximum: 500
          minimum: 10
          type: integer
    - name: fontsize
      in: query
      description: Font size
      schema:
        maximum: 24
        minimum: 2
        type: integer
  /icons:
    get:
      description: Returns a list of icon codes and textual descriptions. Icon services in API are deprecated.
      operationId: icons_summary
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                required:
                - icons
                type: object
                properties:
                  '@context':
                    $ref: '#/components/schemas/JsonLdContext'
                  icons:
                    type: object
                    additionalProperties:
                      required:
                      - description
                      type: object
                      properties:
                        description:
                          type: string
                      additionalProperties: false
                additionalProperties: false
        default:
          $ref: '#/components/responses/Error'
      deprecated: true
      parameters: []
      summary: Weather.gov Returns a List of Icon Codes and Textual Descriptions. Icon Services in API Are Deprecated.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /thumbnails/satellite/{area}:
    get:
      description: Returns a thumbnail image for a satellite region. Image services in API are deprecated.
      operationId: satellite_thumbnails
      responses:
        '200':
          description: An image file
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            image/jpeg:
              schema:
                $ref: '#/components/schemas/BinaryFile'
        default:
          $ref: '#/components/responses/Error'
      deprecated: true
      parameters: []
      summary: Weather.gov Returns a Thumbnail Image for a Satellite Region. Image Services in API Are Deprecated.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: area
      in: path
      description: .
      required: true
      schema:
        enum:
        - a
        - e
        - g
        - h
        - p
        - s
        - w
        type: string
  /stations/{stationId}/observations:
    get:
      description: Returns a list of observations for a given station
      operationId: station_observation_list
      parameters:
      - $ref: '#/components/parameters/QueryStartTime'
        example: example-value
      - $ref: '#/components/parameters/QueryEndTime'
        example: example-value
      - $ref: '#/components/parameters/PaginationCursor'
        example: example-value
      - name: limit
        in: query
        description: Limit
        schema:
          maximum: 500
          minimum: 1
          type: integer
        example: 120
      responses:
        '200':
          $ref: '#/components/responses/ObservationCollection'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Observations for a Given Station
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/ObservationStationId'
  /stations/{stationId}/observations/latest:
    get:
      description: Returns the latest observation for a station
      operationId: station_observation_latest
      parameters:
      - name: require_qc
        in: query
        description: Require QC
        schema:
          type: boolean
        example: true
      responses:
        '200':
          $ref: '#/components/responses/Observation'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns the Latest Observation for a Station
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/ObservationStationId'
  /stations/{stationId}/observations/{time}:
    get:
      description: Returns a single observation.
      operationId: station_observation_time
      parameters:
      - name: time
        in: path
        description: Timestamp of requested observation
        required: true
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      responses:
        '200':
          $ref: '#/components/responses/Observation'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a Single Observation.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/ObservationStationId'
  /stations/{stationId}/tafs:
    get:
      description: Returns Terminal Aerodrome Forecasts for the specified airport station.
      operationId: tafs
      parameters:
      - $ref: '#/components/parameters/ObservationStationId'
        example: example-value
      responses:
        '200':
          description: success
          content:
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Terminal Aerodrome Forecasts for the Specified Airport Station.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /stations/{stationId}/tafs/{date}/{time}:
    get:
      description: Returns a single Terminal Aerodrome Forecast.
      operationId: taf
      parameters:
      - $ref: '#/components/parameters/ObservationStationId'
        example: example-value
      - $ref: '#/components/parameters/Date'
        example: example-value
      - $ref: '#/components/parameters/Time'
        example: example-value
      responses:
        '200':
          description: success
          content:
            application/vnd.wmo.iwxxm+xml:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a Single Terminal Aerodrome Forecast.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /stations:
    get:
      description: Returns a list of observation stations.
      operationId: obs_stations
      parameters:
      - name: id
        in: query
        description: Filter by observation station ID
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
        example:
        - example-value
      - name: state
        in: query
        description: Filter by state/marine area code
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/AreaCode'
        example:
        - KS
      - $ref: '#/components/parameters/Limit'
        example: example-value
      - $ref: '#/components/parameters/PaginationCursor'
        example: example-value
      responses:
        '200':
          $ref: '#/components/responses/ObservationStationCollection'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Observation Stations.
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /stations/{stationId}:
    get:
      description: Returns metadata about a given observation station
      operationId: obs_station
      parameters: []
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ObservationStationGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/ObservationStationJsonLd'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Metadata About a Given Observation Station
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/ObservationStationId'
  /offices/{officeId}:
    get:
      description: Returns metadata about a NWS forecast office
      operationId: office
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/Office'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Metadata About a NWS Forecast Office
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
  /offices/{officeId}/briefing:
    get:
      description: Returns active briefing for an NWS office
      operationId: office_briefing
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/OfficeBriefing'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Active Briefing for an NWS Office
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
  /offices/{officeId}/briefing/download/latest:
    get:
      description: Returns the latest briefing for an office
      operationId: office_briefing_download_latest
      responses:
        '302':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns the Latest Briefing for an Office
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
  /offices/{officeId}/briefing/download/{briefingId}:
    get:
      description: Returns a briefing for an office
      operationId: office_briefing_download
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/pdf:
              schema:
                $ref: '#/components/schemas/BinaryFile'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a Briefing for an Office
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
    - name: briefingId
      in: path
      description: .
      required: true
      schema:
        type: string
  /offices/{officeId}/headlines/{headlineId}:
    get:
      description: Returns a specific news headline for a given NWS office
      operationId: office_headline
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/OfficeHeadline'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a Specific News Headline for a Given NWS Office
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
    - name: headlineId
      in: path
      description: Headline record ID
      required: true
      schema:
        type: string
  /offices/{officeId}/headlines:
    get:
      description: Returns a list of news headlines for a given NWS office
      operationId: office_headlines
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/OfficeHeadlineCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of News Headlines for a Given NWS Office
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
  /offices/{officeId}/weatherstories:
    get:
      description: Returns active weather stories for an NWS office
      operationId: office_weatherstory
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/OfficeWeatherStoryCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Active Weather Stories for an NWS Office
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
  /offices/{officeId}/weatherstories/download/{imageId}:
    get:
      description: Returns the image for a weather story
      operationId: office_weatherstory_image
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            image/*:
              schema:
                $ref: '#/components/schemas/BinaryFile'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns the Image for a Weather Story
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSOfficeId'
    - name: imageId
      in: path
      description: .
      required: true
      schema:
        type: string
  /points/{latitude},{longitude}:
    get:
      description: Returns metadata about a given latitude/longitude point
      operationId: point
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/PointGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/PointJsonLd'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Metadata About a Given Latitude/longitude Point
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/Latitude'
    - $ref: '#/components/parameters/Longitude'
  /points/{latitude},{longitude}/radio:
    get:
      description: Returns NOAA Weather Radio broadcast script for a latitude/longitude point
      externalDocs:
        url: https://www.w3.org/TR/speech-synthesis/
      operationId: point_radio
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ssml+xml:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns NOAA Weather Radio Broadcast Script for a Latitude/longitude Point
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/Latitude'
    - $ref: '#/components/parameters/Longitude'
  /points/{latitude},{longitude}/stations:
    get:
      description: Returns a list of observation stations for a given point
      operationId: point_stations
      responses:
        '301':
          description: redirect to gridpoint stations
        default:
          $ref: '#/components/responses/Error'
      deprecated: true
      parameters: []
      summary: Weather.gov Returns a List of Observation Stations for a Given Point
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/Latitude'
    - $ref: '#/components/parameters/Longitude'
  /radar/servers:
    get:
      description: Returns a list of radar servers
      operationId: radar_servers
      parameters:
      - name: reportingHost
        in: query
        description: Show records from specific reporting host
        schema:
          type: string
        example: example-value
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
            X-Api-Key:
              $ref: '#/components/headers/X-Api-Key'
          content:
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Radar Servers
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /radar/servers/{id}:
    get:
      description: Returns metadata about a given radar server
      operationId: radar_server
      parameters:
      - name: reportingHost
        in: query
        description: Show records from specific reporting host
        schema:
          type: string
        example: example-value
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Metadata About a Given Radar Server
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: id
      in: path
      description: Server ID
      required: true
      schema:
        type: string
  /radar/stations:
    get:
      description: Returns a list of radar stations
      operationId: radar_stations
      parameters:
      - name: stationType
        in: query
        description: Limit results to a specific station type or types
        style: form
        explode: false
        schema:
          type: array
          items:
            pattern: ^[A-Za-z0-9-]+$
            type: string
        example:
        - KTOP
      - name: reportingHost
        in: query
        description: Show RDA and latency info from specific reporting host
        schema:
          type: string
        example: example-value
      - name: host
        in: query
        description: Show latency info from specific LDM host
        schema:
          type: string
        example: example-value
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema: {}
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Radar Stations
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /radar/stations/{stationId}:
    get:
      description: Returns metadata about a given radar station
      operationId: radar_station
      parameters:
      - name: reportingHost
        in: query
        description: Show RDA and latency info from specific reporting host
        schema:
          type: string
        example: example-value
      - name: host
        in: query
        description: Show latency info from specific LDM host
        schema:
          type: string
        example: example-value
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema: {}
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Metadata About a Given Radar Station
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: stationId
      in: path
      description: Radar station ID
      required: true
      schema:
        type: string
  /radar/stations/{stationId}/alarms:
    get:
      description: Returns metadata about a given radar station alarms
      operationId: radar_station_alarms
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Metadata About a Given Radar Station Alarms
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: stationId
      in: path
      description: Radar station ID
      required: true
      schema:
        type: string
  /radar/queues/{host}:
    get:
      description: Returns metadata about a given radar queue
      operationId: radar_queue
      parameters:
      - name: limit
        in: query
        description: Record limit
        schema:
          maximum: 50000
          minimum: 1
          type: integer
        example: 4404
      - name: arrived
        in: query
        description: Range for arrival time
        schema:
          $ref: '#/components/schemas/ISO8601Interval'
      - name: created
        in: query
        description: Range for creation time
        schema:
          $ref: '#/components/schemas/ISO8601Interval'
      - name: published
        in: query
        description: Range for publish time
        schema:
          $ref: '#/components/schemas/ISO8601Interval'
      - name: station
        in: query
        description: Station identifier
        schema:
          type: string
        example: KTOP
      - name: type
        in: query
        description: Record type
        schema:
          type: string
        example: land
      - name: feed
        in: query
        description: Originating product feed
        schema:
          type: string
        example: example-value
      - name: resolution
        in: query
        description: Resolution version
        schema:
          minimum: 1
          type: integer
        example: 50
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Metadata About a Given Radar Queue
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: host
      in: path
      description: LDM host
      required: true
      schema:
        enum:
        - rds
        - tds
        type: string
  /radar/profilers/{stationId}:
    get:
      description: Returns metadata about a given radar wind profiler
      operationId: radar_profiler
      parameters:
      - name: time
        in: query
        description: Time interval
        schema:
          $ref: '#/components/schemas/ISO8601Interval'
      - name: interval
        in: query
        description: Averaging interval
        schema:
          $ref: '#/components/schemas/ISO8601Duration'
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Metadata About a Given Radar Wind Profiler
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: stationId
      in: path
      description: Profiler station ID
      required: true
      schema:
        type: string
  /radio/{callSign}/broadcast:
    get:
      description: Returns NOAA Weather Radio broadcast script for a transmitter
      externalDocs:
        url: https://www.w3.org/TR/speech-synthesis/
      operationId: area_radio
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ssml+xml:
              schema: {}
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns NOAA Weather Radio Broadcast Script for a Transmitter
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/CallSign'
  /products:
    get:
      description: Returns a list of text products
      operationId: products_query
      parameters:
      - name: location
        in: query
        description: Location id
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
        example:
        - example-value
      - name: start
        in: query
        description: Start time
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      - name: end
        in: query
        description: End time
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      - name: office
        in: query
        description: Issuing office
        style: form
        explode: false
        schema:
          type: array
          items:
            pattern: ^[A-Z]{4}$
            type: string
        example:
        - TOP
      - name: wmoid
        in: query
        description: WMO id code
        style: form
        explode: false
        schema:
          type: array
          items:
            pattern: ^[A-Z]{4}\d{2}$
            type: string
        example:
        - example-value
      - name: type
        in: query
        description: Product code
        style: form
        explode: false
        schema:
          type: array
          items:
            pattern: ^\w{3}$
            type: string
        example:
        - land
      - name: limit
        in: query
        description: Limit
        schema:
          maximum: 500
          minimum: 1
          type: integer
        example: 422
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProductCollection'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Text Products
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /products/locations:
    get:
      description: Returns a list of valid text product issuance locations
      operationId: product_locations
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProductLocationCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Valid Text Product Issuance Locations
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /products/types:
    get:
      description: Returns a list of valid text product types and codes
      operationId: product_types
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProductTypeCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Valid Text Product Types and Codes
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /products/{productId}:
    get:
      description: Returns a specific text product
      operationId: product
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProduct'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a Specific Text Product
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: productId
      in: path
      description: .
      required: true
      schema:
        type: string
  /products/types/{typeId}:
    get:
      description: Returns a list of text products of a given type
      operationId: products_type
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProductCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Text Products of a Given Type
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: typeId
      in: path
      description: .
      required: true
      schema:
        type: string
  /products/types/{typeId}/locations:
    get:
      description: Returns a list of valid text product issuance locations for a given product type
      operationId: products_type_locations
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProductLocationCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Valid Text Product Issuance Locations for a Given Product Type
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: typeId
      in: path
      description: .
      required: true
      schema:
        type: string
  /products/locations/{locationId}/types:
    get:
      description: Returns a list of valid text product types for a given issuance location
      operationId: location_products
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProductTypeCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Valid Text Product Types for a Given Issuance Location
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: locationId
      in: path
      description: .
      required: true
      schema:
        type: string
  /products/types/{typeId}/locations/{locationId}:
    get:
      description: Returns a list of text products of a given type for a given issuance location
      operationId: products_type_location
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProductCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Text Products of a Given Type for a Given Issuance Location
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: typeId
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: locationId
      in: path
      description: .
      required: true
      schema:
        type: string
  /products/types/{typeId}/locations/{locationId}/latest:
    get:
      description: Returns latest text products of a given type for a given issuance location with product text
      operationId: latest_product_type_location
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/ld+json:
              schema:
                $ref: '#/components/schemas/TextProduct'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns Latest Text Products of a Given Type for a Given Issuance Location with Product Text
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: typeId
      in: path
      description: .
      required: true
      schema:
        type: string
    - name: locationId
      in: path
      description: .
      required: true
      schema:
        type: string
  /zones:
    get:
      description: Returns a list of zones
      operationId: zone_list
      parameters:
      - name: id
        in: query
        description: Zone ID (forecast or county)
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/NWSZoneID'
        example:
        - example-value
      - name: area
        in: query
        description: State/marine area code
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/AreaCode'
        example:
        - example-value
      - name: region
        in: query
        description: Region code
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/RegionCode'
        example:
        - example-value
      - name: type
        in: query
        description: Zone type
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/NWSZoneType'
        example:
        - land
      - name: point
        in: query
        description: Point (latitude,longitude)
        schema:
          $ref: '#/components/schemas/PointString'
      - name: include_geometry
        in: query
        description: Include geometry in results (true/false)
        schema:
          type: boolean
        example: true
      - name: limit
        in: query
        description: Limit
        schema:
          minimum: 1
          type: integer
        example: 20
      - name: effective
        in: query
        description: Effective date/time
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ZoneCollectionGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/ZoneCollectionJsonLd'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Zones
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /zones/{type}:
    get:
      description: Returns a list of zones of a given type
      operationId: zone_list_type
      parameters:
      - name: id
        in: query
        description: Zone ID (forecast or county)
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/NWSZoneID'
        example:
        - example-value
      - name: area
        in: query
        description: State/marine area code
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/AreaCode'
        example:
        - example-value
      - name: region
        in: query
        description: Region code
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/RegionCode'
        example:
        - example-value
      - name: type
        in: query
        description: Zone type
        style: form
        explode: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/NWSZoneType'
        example:
        - land
      - name: point
        in: query
        description: Point (latitude,longitude)
        schema:
          $ref: '#/components/schemas/PointString'
      - name: include_geometry
        in: query
        description: Include geometry in results (true/false)
        schema:
          type: boolean
        example: true
      - name: limit
        in: query
        description: Limit
        schema:
          minimum: 1
          type: integer
        example: 80
      - name: effective
        in: query
        description: Effective date/time
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ZoneCollectionGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/ZoneCollectionJsonLd'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Zones of a Given Type
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: type
      in: path
      description: Zone type
      required: true
      schema:
        $ref: '#/components/schemas/NWSZoneType'
  /zones/{type}/{zoneId}:
    get:
      description: Returns metadata about a given zone
      operationId: zone
      parameters:
      - name: effective
        in: query
        description: Effective date/time
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ZoneGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/ZoneJsonLd'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns Metadata About a Given Zone
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: type
      in: path
      description: Zone type
      required: true
      schema:
        $ref: '#/components/schemas/NWSZoneType'
    - $ref: '#/components/parameters/NWSZoneId'
  /zones/{type}/{zoneId}/forecast:
    get:
      description: Returns the current zone forecast for a given zone
      operationId: zone_forecast
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ZoneForecastGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/ZoneForecastJsonLd'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns the Current Zone Forecast for a Given Zone
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - name: type
      in: path
      description: Zone type
      required: true
      schema:
        type: string
    - $ref: '#/components/parameters/NWSZoneId'
  /zones/forecast/{zoneId}/observations:
    get:
      description: Returns a list of observations for a given zone
      operationId: zone_obs
      parameters:
      - name: start
        in: query
        description: Start date/time
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      - name: end
        in: query
        description: End date/time
        schema:
          type: string
          format: date-time
        example: '2026-05-03T14:30:00Z'
      - name: limit
        in: query
        description: Limit
        schema:
          maximum: 500
          minimum: 1
          type: integer
        example: 1
      responses:
        '200':
          description: success
          headers:
            X-Correlation-Id:
              $ref: '#/components/headers/CorrelationId'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Server-Id:
              $ref: '#/components/headers/ServerId'
          content:
            application/geo+json:
              schema:
                $ref: '#/components/schemas/ObservationCollectionGeoJson'
            application/ld+json:
              schema:
                $ref: '#/components/schemas/ObservationCollectionJsonLd'
        default:
          $ref: '#/components/responses/Error'
      summary: Weather.gov Returns a List of Observations for a Given Zone
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSZoneId'
  /zones/forecast/{zoneId}/stations:
    get:
      description: Returns a list of observation stations for a given zone
      operationId: zone_stations
      responses:
        '200':
          $ref: '#/components/responses/ObservationStationCollection'
        default:
          $ref: '#/components/responses/Error'
      parameters: []
      summary: Weather.gov Returns a List of Observation Stations for a Given Zone
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    parameters:
    - $ref: '#/components/parameters/NWSZoneId'
    - $ref: '#/components/parameters/Limit'
    - $ref: '#/components/parameters/PaginationCursor'
components:
  schemas:
    Alert:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/AlertId'
        areaDesc:
          type: string
          description: A textual description of the area affected by the alert.
        geocode:
          type: object
          properties:
            UGC:
              type: array
              items:
                $ref: '#/components/schemas/NWSZoneID'
              description: A list of NWS public zone or county identifiers.
            SAME:
              type: array
              items:
                pattern: ^\d{6}$
                type: string
              description: A list of SAME (Specific Area Message Encoding) codes for affected counties.
          description: Lists of codes for NWS public zones and counties affected by the alert.
        affectedZones:
          type: array
          items:
            type: string
            format: uri
          description: "An array of API links for zones affected by the alert. This is an API-specific extension field and is not part of the CAP specification.\n"
        references:
          type: array
          items:
            type: object
            properties:
              '@id':
                type: string
                description: An API link to the prior alert.
                format: uri
              identifier:
                $ref: '#/components/schemas/AlertId'
              sender:
                type: string
                description: The sender of the prior alert.
              sent:
                type: string
                description: The time the prior alert was sent.
                format: date-time
          description: A list of prior alerts that this alert updates or replaces.
        sent:
          type: string
          description: The time of the origination of the alert message.
          format: date-time
        effective:
          type: string
          description: The effective time of the information of the alert message.
          format: date-time
        onset:
          type:
          - string
          - 'null'
          description: The expected time of the beginning of the subject event of the alert message.
          format: date-time
        expires:
          type: string
          description: The expiry time of the information of the alert message.
          format: date-time
        ends:
          type:
          - string
          - 'null'
          description: The expected end time of the subject event of the alert message.
          format: date-time
        status:
          $ref: '#/components/schemas/AlertStatus'
        messageType:
          $ref: '#/components/schemas/AlertMessageType'
        category:
          enum:
          - Met
          - Geo
          - Safety
          - Security
          - Rescue
          - Fire
          - Health
          - Env
          - Transport
          - Infra
          - CBRNE
          - Other
          type: string
          description: The code denoting the category of the subject event of the alert message.
        severity:
          $ref: '#/components/schemas/AlertSeverity'
        certainty:
          $ref: '#/components/schemas/AlertCertainty'
        urgency:
          $ref: '#/components/schemas/AlertUrgency'
        event:
          type: string
          description: The text denoting the type of the subject event of the alert message.
        sender:
          type: string
          description: Email address of the NWS webmaster.
        senderName:
          type: string
          description: The text naming the originator of the alert message.
        headline:
          type:
          - string
          - 'null'
          description: The text headline of the alert message.
        description:
          type: string
          description: The text describing the subject event of the alert message.
        instruction:
          type:
          - string
          - 'null'
          description: "The text describing the recommended action to be taken by recipients of the alert message.\n"
        note:
          type:
          - string
          - 'null'
          description: "The text note accompanying the alert message. Per CAP spec, this should accompany alerts with a status of \"Test\".\n"
        response:
          enum:
          - Shelter
          - Evacuate
          - Prepare
          - Execute
          - Avoid
          - Monitor
          - Assess
          - AllClear
          - None
          type: string
          description: "The code denoting the type of action recommended for the target audience.\nThis corresponds to responseType in the CAP specification.\n"
        parameters:
          type: object
          description: "System-specific additional parameters associated with the alert message.\nThe keys in this object correspond to parameter definitions in the NWS CAP specification.\n"
          additionalProperties:
            type: array
            items: {}
        scope:
          enum:
          - Public
          - Restricted
          - Private
          type: string
          description: The code denoting the intended distribution of the alert message.
        code:
          type: string
          description: The code denoting the special handling of the alert message.
        language:
          type: string
          description: The code denoting the language of the info sub-element of the alert message.
        web:
          type: string
          description: The identifier of the hyperlink associating additional information within the alert message.
        eventCode:
          type: object
          description: "System-specific code identifiying the event type of the alert message The keys in this object correspond to eventCode definitions in the NWS CAP specification.\n"
          additionalProperties:
            type: array
            items: {}
      description: "An object representing a public alert message.\nUnless otherwise noted, the fields in this object correspond to the National Weather Service CAP v1.2 specification, which extends the
        OASIS Common Alerting Protocol (CAP) v1.2 specification and USA Integrated Public Alert and Warning System (IPAWS) Profile v1.0. Refer to this documentation for more complete information.\nhttp://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html
        http://docs.oasis-open.org/emergency/cap/v1.2/ipaws-profile/v1.0/cs01/cap-v1.2-ipaws-profile-cs01.html https://vlab.noaa.gov/web/nws-common-alerting-protocol/cap-documentation\n"
    AlertCollection:
      type: object
      properties:
        title:
          type: string
          description: A title describing the alert collection
        updated:
          type: string
          description: The last time a change occurred to this collection
          format: date-time
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
    AlertCollectionGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeatureCollection'
      - type: object
        properties:
          features:
            type: array
            items:
              type: object
              properties:
                properties:
                  $ref: '#/components/schemas/Alert'
      - $ref: '#/components/schemas/AlertCollection'
    AlertCollectionJsonLd:
      allOf:
      - $ref: '#/components/schemas/AlertCollection'
      - type: object
        properties:
          '@context':
            $ref: '#/components/schemas/JsonLdContext'
          '@graph':
            type: array
            items:
              $ref: '#/components/schemas/Alert'
    AlertCap:
      type: object
    AlertGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/Alert'
    AlertJsonLd:
      type: object
      properties:
        '@graph':
          type: array
          items:
            $ref: '#/components/schemas/Alert'
    AlertId:
      type: string
      description: The identifier of the alert message.
    AlertCertainty:
      enum:
      - Observed
      - Likely
      - Possible
      - Unlikely
      - Unknown
      type: string
    AlertMessageType:
      enum:
      - Alert
      - Update
      - Cancel
      - Ack
      - Error
      type: string
    AlertSeverity:
      enum:
      - Extreme
      - Severe
      - Moderate
      - Minor
      - Unknown
      type: string
    AlertStatus:
      enum:
      - Actual
      - Exercise
      - System
      - Test
      - Draft
      type: string
    AlertUrgency:
      enum:
      - Immediate
      - Expected
      - Future
      - Past
      - Unknown
      type: string
    AlertAtomEntry:
      type: object
      properties:
        id:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        updated:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        published:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        author:
          type: object
          properties:
            name:
              type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        summary:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        event:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        sent:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        effective:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        expires:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        status:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        msgType:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        category:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        urgency:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        severity:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        certainty:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        areaDesc:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        polygon:
          type: string
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        geocode:
          type: array
          items:
            $ref: '#/components/schemas/AlertXMLParameter'
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
        parameter:
          type: array
          items:
            $ref: '#/components/schemas/AlertXMLParameter'
          xml:
            namespace: urn:oasis:names:tc:emergency:cap:1.2
      description: An alert entry in an Atom feed
      xml:
        name: entry
        namespace: http://www.w3.org/2005/Atom
    AlertXMLParameter:
      type: object
      properties:
        valueName:
          type: string
        value:
          type: string
    AlertAtomFeed:
      type: object
      properties:
        id:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        generator:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        updated:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        author:
          type: object
          properties:
            name:
              type: string
              xml:
                namespace: http://www.w3.org/2005/Atom
          xml:
            namespace: http://www.w3.org/2005/Atom
        title:
          type: string
          xml:
            namespace: http://www.w3.org/2005/Atom
        entry:
          type: array
          items:
            $ref: '#/components/schemas/AlertAtomEntry'
          xml:
            namespace: http://www.w3.org/2005/Atom
      description: An alert feed in Atom format
      xml:
        name: feed
        namespace: http://www.w3.org/2005/Atom
    AreaCode:
      oneOf:
      - $ref: '#/components/schemas/StateTerritoryCode'
      - $ref: '#/components/schemas/MarineAreaCode'
      description: State/territory codes and marine area codes
    AstronomicalData:
      type: object
      properties:
        sunrise:
          type: string
          description: "The timestamp of sunrise, defined as when the sun angle is 90°35' from vertical.\n"
          format: date-time
        sunset:
          type: string
          description: "The timestamp of sunset, defined as when the sun angle is 90°35' from vertical.\n"
          format: date-time
        transit:
          type: string
          description: "The timestamp when the sun reaches its zenith.\n"
          format: date-time
        civilTwilightBegin:
          type: string
          description: "The timestamp of the onset of civil twilight, defined as when the sun angle is 96° from vertical. This is the beginning of civil dawn and lasts until sunrise.\n"
          format: date-time
        civilTwilightEnd:
          type: string
          description: "The timestamp of the end of civil twilight, defined as when the sun angle is 96° from vertical. This is the end of civil dusk, which begins at sunset.\n"
          format: date-time
        nauticalTwilightBegin:
          type: string
          description: "The timestamp of the onset of nautical twilight, defined as when the sun angle is 102° from vertical. This is the beginning of nautical dawn and lasts until the civil dawn.\n"
          format: date-time
        nauticalTwilightEnd:
          type: string
          description: "The timestamp of the end of nautical twilight, defined as when the sun angle is 102° from vertical. This is the end of nautical dusk, which begins at the end of civil twilight.\n"
          format: date-time
        astronomicalTwilightBegin:
          type: string
          description: "The timestamp of the onset of astronomical twilight, defined as when the sun angle is 108° from vertical. This is the beginning of astronomical dawn and lasts until the nautical
            dawn.\n"
          format: date-time
        astronomicalTwilightEnd:
          type: string
          description: "The timestamp of the end of astronomical twilight, defined as when the sun angle is 108° from vertical. This is the end of astronomical dusk, which begins at the end of nautical
            twilight.\n"
          format: date-time
      description: "An object representing sunrise, sunset, and twilight information for a location.\n"
    ATSUIdentifier:
      pattern: ^[A-Z]{3,4}$
      type: string
      description: ATSU Identifier
    BinaryFile:
      type: string
      format: binary
    CenterWeatherAdvisoryCollectionGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeatureCollection'
      - type: object
        properties:
          features:
            type: array
            items:
              type: object
              properties:
                properties:
                  $ref: '#/components/schemas/CenterWeatherAdvisory'
    CenterWeatherAdvisoryGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/CenterWeatherAdvisory'
    CenterWeatherAdvisory:
      type: object
      properties:
        id:
          type: string
        issueTime:
          type: string
          format: date-time
        cwsu:
          $ref: '#/components/schemas/NWSCenterWeatherServiceUnitId'
        sequence:
          minimum: 101
          type: integer
        start:
          type: string
          format: date-time
        end:
          type: string
          format: date-time
        observedProperty:
          type: string
        text:
          type: string
      additionalProperties: false
    CenterWeatherServiceUnitJsonLd:
      $ref: '#/components/schemas/Office'
    Date:
      type: string
      description: Date (in YYYY-MM-DD format).
      format: date
    GeometryString:
      type:
      - string
      - 'null'
      description: A geometry represented in Well-Known Text (WKT) format.
      format: wkt
    GeoJsonBoundingBox:
      minItems: 4
      type: array
      items:
        type: number
      description: A GeoJSON bounding box. Please refer to IETF RFC 7946 for information on the GeoJSON format.
    GeoJsonCoordinate:
      minItems: 2
      type: array
      items:
        type: number
      description: A GeoJSON coordinate. Please refer to IETF RFC 7946 for information on the GeoJSON format.
    GeoJsonGeometry:
      oneOf:
      - title: GeoJSON Point
        required:
        - type
        - coordinates
        type: object
        properties:
          type:
            enum:
            - Point
            type: string
          coordinates:
            $ref: '#/components/schemas/GeoJsonCoordinate'
          bbox:
            $ref: '#/components/schemas/GeoJsonBoundingBox'
      - title: GeoJSON LineString
        required:
        - type
        - coordinates
        type: object
        properties:
          type:
            enum:
            - LineString
            type: string
          coordinates:
            $ref: '#/components/schemas/GeoJsonLineString'
          bbox:
            $ref: '#/components/schemas/GeoJsonBoundingBox'
      - title: GeoJSON Polygon
        required:
        - type
        - coordinates
        type: object
        properties:
          type:
            enum:
            - Polygon
            type: string
          coordinates:
            $ref: '#/components/schemas/GeoJsonPolygon'
          bbox:
            $ref: '#/components/schemas/GeoJsonBoundingBox'
      - title: GeoJSON MultiPoint
        required:
        - type
        - coordinates
        type: object
        properties:
          type:
            enum:
            - MultiPoint
            type: string
          coordinates:
            type: array
            items:
              $ref: '#/components/schemas/GeoJsonCoordinate'
          bbox:
            $ref: '#/components/schemas/GeoJsonBoundingBox'
      - title: GeoJSON MultiLineString
        required:
        - type
        - coordinates
        type: object
        properties:
          type:
            enum:
            - MultiLineString
            type: string
          coordinates:
            type: array
            items:
              $ref: '#/components/schemas/GeoJsonLineString'
          bbox:
            $ref: '#/components/schemas/GeoJsonBoundingBox'
      - title: GeoJSON MultiPolygon
        required:
        - type
        - coordinates
        type: object
        properties:
          type:
            enum:
            - MultiPolygon
            type: string
          coordinates:
            type: array
            items:
              $ref: '#/components/schemas/GeoJsonPolygon'
          bbox:
            $ref: '#/components/schemas/GeoJsonBoundingBox'
      - type: 'null'
      description: A GeoJSON geometry object. Please refer to IETF RFC 7946 for information on the GeoJSON format.
    GeoJsonFeature:
      required:
      - type
      - geometry
      - properties
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        id:
          type: string
          format: uri
        type:
          enum:
          - Feature
          type: string
        geometry:
          $ref: '#/components/schemas/GeoJsonGeometry'
        properties:
          type: object
      description: A GeoJSON feature. Please refer to IETF RFC 7946 for information on the GeoJSON format.
      additionalProperties: false
    GeoJsonFeatureCollection:
      required:
      - type
      - features
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        type:
          enum:
          - FeatureCollection
          type: string
        features:
          type: array
          items:
            $ref: '#/components/schemas/GeoJsonFeature'
      description: A GeoJSON feature collection. Please refer to IETF RFC 7946 for information on the GeoJSON format.
    GeoJsonLineString:
      minItems: 2
      type: array
      items:
        $ref: '#/components/schemas/GeoJsonCoordinate'
      description: A GeoJSON line string. Please refer to IETF RFC 7946 for information on the GeoJSON format.
    GeoJsonPolygon:
      type: array
      items:
        minItems: 4
        type: array
        items:
          $ref: '#/components/schemas/GeoJsonCoordinate'
      description: A GeoJSON polygon. Please refer to IETF RFC 7946 for information on the GeoJSON format.
    Gridpoint:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        '@id':
          type: string
          format: uri
        '@type':
          enum:
          - wx:Gridpoint
          type: string
        updateTime:
          type: string
          format: date-time
        validTimes:
          $ref: '#/components/schemas/ISO8601Interval'
        elevation:
          $ref: '#/components/schemas/QuantitativeValue'
        forecastOffice:
          type: string
          format: uri
        gridId:
          type: string
        gridX:
          minimum: 0
          type: integer
        gridY:
          minimum: 0
          type: integer
        weather:
          required:
          - values
          type: object
          properties:
            values:
              type: array
              items:
                required:
                - validTime
                - value
                type: object
                properties:
                  validTime:
                    $ref: '#/components/schemas/ISO8601Interval'
                  value:
                    type: array
                    items:
                      required:
                      - coverage
                      - weather
                      - intensity
                      - visibility
                      - attributes
                      type: object
                      properties:
                        coverage:
                          enum:
                          - areas
                          - brief
                          - chance
                          - definite
                          - few
                          - frequent
                          - intermittent
                          - isolated
                          - likely
                          - numerous
                          - occasional
                          - patchy
                          - periods
                          - scattered
                          - slight_chance
                          - widespread
                          type:
                          - string
                          - 'null'
                        weather:
                          enum:
                          - blowing_dust
                          - blowing_sand
                          - blowing_snow
                          - drizzle
                          - fog
                          - freezing_fog
                          - freezing_drizzle
                          - freezing_rain
                          - freezing_spray
                          - frost
                          - hail
                          - haze
                          - ice_crystals
                          - ice_fog
                          - rain
                          - rain_showers
                          - sleet
                          - smoke
                          - snow
                          - snow_showers
                          - thunderstorms
                          - volcanic_ash
                          - water_spouts
                          type:
                          - string
                          - 'null'
                        intensity:
                          enum:
                          - very_light
                          - light
                          - moderate
                          - heavy
                          type:
                          - string
                          - 'null'
                        visibility:
                          $ref: '#/components/schemas/QuantitativeValue'
                        attributes:
                          type: array
                          items:
                            enum:
                            - damaging_wind
                            - dry_thunderstorms
                            - flooding
                            - gusty_wind
                            - heavy_rain
                            - large_hail
                            - small_hail
                            - tornadoes
                            type: string
                      description: A value object representing expected weather phenomena.
                      additionalProperties: false
                additionalProperties: false
        hazards:
          required:
          - values
          type: object
          properties:
            values:
              type: array
              items:
                required:
                - validTime
                - value
                type: object
                properties:
                  validTime:
                    $ref: '#/components/schemas/ISO8601Interval'
                  value:
                    type: array
                    items:
                      required:
                      - phenomenon
                      - significance
                      - event_number
                      type: object
                      properties:
                        phenomenon:
                          pattern: ^\w{2}$
                          type: string
                          description: "Hazard code. This value will correspond to a P-VTEC phenomenon code as defined in NWS Directive 10-1703.\n"
                        significance:
                          pattern: ^\w$
                          type: string
                          description: "Significance code. This value will correspond to a P-VTEC significance code as defined in NWS Directive 10-1703.\nThis will most frequently be \"A\" for a watch or
                            \"Y\" for an advisory.\n"
                        event_number:
                          type:
                          - integer
                          - 'null'
                          description: "Event number. If this hazard refers to a national or regional center product (such as a Storm Prediction Center convective watch), this value will be the sequence
                            number of that product.\n"
                      description: A value object representing an expected hazard.
                additionalProperties: false
      description: "Raw forecast data for a 2.5km grid square.\nThis is a list of all potential data layers that may appear. Some layers may not be present in all areas.\n* temperature\n* dewpoint\n* maxTemperature\n\
        * minTemperature\n* relativeHumidity\n* apparentTemperature\n* heatIndex\n* windChill\n* wetBulbGlobeTemperature\n* skyCover\n* windDirection\n* windSpeed\n* windGust\n* weather\n* hazards: Watch
        and advisory products in effect\n* heatRisk\n* probabilityOfPrecipitation\n* quantitativePrecipitation\n* iceAccumulation\n* snowfallAmount\n* snowLevel\n* ceilingHeight\n* visibility\n* transportWindSpeed\n\
        * transportWindDirection\n* mixingHeight\n* hainesIndex\n* lightningActivityLevel\n* twentyFootWindSpeed\n* twentyFootWindDirection\n* waveHeight\n* wavePeriod\n* waveDirection\n* primarySwellHeight\n\
        * primarySwellDirection\n* secondarySwellHeight\n* secondarySwellDirection\n* wavePeriod2\n* windWaveHeight\n* dispersionIndex\n* pressure: Barometric pressure\n* probabilityOfTropicalStormWinds\n\
        * probabilityOfHurricaneWinds\n* potentialOf15mphWinds\n* potentialOf25mphWinds\n* potentialOf35mphWinds\n* potentialOf45mphWinds\n* potentialOf20mphWindGusts\n* potentialOf30mphWindGusts\n* potentialOf40mphWindGusts\n\
        * potentialOf50mphWindGusts\n* potentialOf60mphWindGusts\n* grasslandFireDangerIndex\n* probabilityOfThunder\n* davisStabilityIndex\n* atmosphericDispersionIndex\n* lowVisibilityOccurrenceRiskIndex\n\
        * stability\n* redFlagThreatIndex\n"
      additionalProperties:
        $ref: '#/components/schemas/GridpointQuantitativeValueLayer'
    GridpointQuantitativeValueLayer:
      required:
      - values
      type: object
      properties:
        uom:
          $ref: '#/components/schemas/UnitOfMeasure'
        values:
          type: array
          items:
            required:
            - validTime
            - value
            type: object
            properties:
              validTime:
                $ref: '#/components/schemas/ISO8601Interval'
              value:
                type:
                - number
                - 'null'
            additionalProperties: false
      description: "A gridpoint layer consisting of quantitative values (numeric values with associated units of measure).\n"
    GridpointGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/Gridpoint'
    GridpointJsonLd:
      $ref: '#/components/schemas/Gridpoint'
    Gridpoint12hForecast:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        units:
          $ref: '#/components/schemas/GridpointForecastUnits'
        forecastGenerator:
          type: string
          description: The internal generator class used to create the forecast text (used for NWS debugging).
        generatedAt:
          type: string
          description: The time this forecast data was generated.
          format: date-time
        updateTime:
          type: string
          description: The last update time of the data this forecast was generated from.
          format: date-time
        validTimes:
          $ref: '#/components/schemas/ISO8601Interval'
        elevation:
          $ref: '#/components/schemas/QuantitativeValue'
        periods:
          type: array
          items:
            $ref: '#/components/schemas/Gridpoint12hForecastPeriod'
          description: An array of forecast periods.
      description: A multi-day forecast for a 2.5km grid square.
      additionalProperties: false
    GridpointHourlyForecast:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        units:
          $ref: '#/components/schemas/GridpointForecastUnits'
        forecastGenerator:
          type: string
          description: The internal generator class used to create the forecast text (used for NWS debugging).
        generatedAt:
          type: string
          description: The time this forecast data was generated.
          format: date-time
        updateTime:
          type: string
          description: The last update time of the data this forecast was generated from.
          format: date-time
        validTimes:
          $ref: '#/components/schemas/ISO8601Interval'
        elevation:
          $ref: '#/components/schemas/QuantitativeValue'
        periods:
          type: array
          items:
            $ref: '#/components/schemas/GridpointHourlyForecastPeriod'
          description: An array of forecast periods.
      description: An hourly forecast for a 2.5km grid square.
      additionalProperties: false
    GridpointHourlyForecastPeriod:
      type: object
      properties:
        number:
          minimum: 1
          type: integer
          description: Sequential period number.
        name:
          type: string
          description: "A textual identifier for the period. This value will not be present for hourly forecasts.\n"
          examples:
          - Tuesday Night
        startTime:
          type: string
          description: The starting time that this forecast period is valid for.
          format: date-time
        endTime:
          type: string
          description: The ending time that this forecast period is valid for.
          format: date-time
        isDaytime:
          type: boolean
          description: Indicates whether this period is daytime or nighttime.
        temperature:
          oneOf:
          - $ref: '#/components/schemas/QuantitativeValue'
          - type: integer
          description: "High/low temperature for the period, depending on whether the period is day or night.\nThis property as an integer value is deprecated. Future versions will express this value as
            a quantitative value object. To make use of the future standard format now, set the \"forecast_temperature_qv\" feature flag on the request.\n"
        temperatureUnit:
          enum:
          - F
          - C
          type: string
          description: "The unit of the temperature value (Fahrenheit or Celsius).\nThis property is deprecated. Future versions will indicate the unit within the quantitative value object for the temperature
            property. To make use of the future standard format now, set the \"forecast_temperature_qv\" feature flag on the request.\n"
          deprecated: true
        temperatureTrend:
          enum:
          - rising
          - falling
          type:
          - string
          - 'null'
          description: "If not null, indicates a non-diurnal temperature trend for the period (either rising temperature overnight, or falling temperature during the day)\n"
        probabilityOfPrecipitation:
          $ref: '#/components/schemas/QuantitativeValue'
          description: Probability of precipitation for the period.
        dewpoint:
          $ref: '#/components/schemas/QuantitativeValue'
          description: "Dewpoint. Only provided in hourly forecasts.\n"
        relativeHumidity:
          $ref: '#/components/schemas/QuantitativeValue'
          description: "Relative humidity. Only provided in hourly forecasts.\n"
        windSpeed:
          oneOf:
          - $ref: '#/components/schemas/QuantitativeValue'
          - type: string
          description: "Wind speed for the period.\nThis property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future standard
            format now, set the \"forecast_wind_speed_qv\" feature flag on the request.\n"
        windGust:
          oneOf:
          - $ref: '#/components/schemas/QuantitativeValue'
          - type: string
          - type: 'null'
          description: "Peak wind gust for the period.\nThis property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future
            standard format now, set the \"forecast_wind_speed_qv\" feature flag on the request.\n"
        windDirection:
          enum:
          - N
          - NNE
          - NE
          - ENE
          - E
          - ESE
          - SE
          - SSE
          - S
          - SSW
          - SW
          - WSW
          - W
          - WNW
          - NW
          - NNW
          type: string
          description: The prevailing direction of the wind for the period, using a 16-point compass.
        icon:
          type: string
          description: A link to an icon representing the forecast summary.
          format: uri
          deprecated: true
        shortForecast:
          type: string
          description: A brief textual forecast summary for the period.
        detailedForecast:
          type: string
          description: A detailed textual forecast for the period.
      description: "An object containing forecast information for a specific time period (generally 12-hour or 1-hour).\n"
      additionalProperties: false
    Gridpoint12hForecastPeriod:
      type: object
      properties:
        number:
          minimum: 1
          type: integer
          description: Sequential period number.
        name:
          type: string
          description: "A textual identifier for the period. This value will not be present for hourly forecasts.\n"
          examples:
          - Tuesday Night
        startTime:
          type: string
          description: The starting time that this forecast period is valid for.
          format: date-time
        endTime:
          type: string
          description: The ending time that this forecast period is valid for.
          format: date-time
        isDaytime:
          type: boolean
          description: Indicates whether this period is daytime or nighttime.
        temperature:
          oneOf:
          - $ref: '#/components/schemas/QuantitativeValue'
          - type: integer
          description: "High/low temperature for the period, depending on whether the period is day or night.\nThis property as an integer value is deprecated. Future versions will express this value as
            a quantitative value object. To make use of the future standard format now, set the \"forecast_temperature_qv\" feature flag on the request.\n"
        temperatureUnit:
          enum:
          - F
          - C
          type: string
          description: "The unit of the temperature value (Fahrenheit or Celsius).\nThis property is deprecated. Future versions will indicate the unit within the quantitative value object for the temperature
            property. To make use of the future standard format now, set the \"forecast_temperature_qv\" feature flag on the request.\n"
          deprecated: true
        temperatureTrend:
          enum:
          - rising
          - falling
          type:
          - string
          - 'null'
          description: "If not null, indicates a non-diurnal temperature trend for the period (either rising temperature overnight, or falling temperature during the day)\n"
        probabilityOfPrecipitation:
          $ref: '#/components/schemas/QuantitativeValue'
          description: Probability of precipitation for the period.
        windSpeed:
          oneOf:
          - $ref: '#/components/schemas/QuantitativeValue'
          - type: string
          description: "Wind speed for the period.\nThis property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future standard
            format now, set the \"forecast_wind_speed_qv\" feature flag on the request.\n"
        windGust:
          oneOf:
          - $ref: '#/components/schemas/QuantitativeValue'
          - type: string
          - type: 'null'
          description: "Peak wind gust for the period.\nThis property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future
            standard format now, set the \"forecast_wind_speed_qv\" feature flag on the request.\n"
        windDirection:
          enum:
          - N
          - NNE
          - NE
          - ENE
          - E
          - ESE
          - SE
          - SSE
          - S
          - SSW
          - SW
          - WSW
          - W
          - WNW
          - NW
          - NNW
          type: string
          description: The prevailing direction of the wind for the period, using a 16-point compass.
        icon:
          type: string
          description: A link to an icon representing the forecast summary.
          format: uri
          deprecated: true
        shortForecast:
          type: string
          description: A brief textual forecast summary for the period.
        detailedForecast:
          type: string
          description: A detailed textual forecast for the period.
      description: "An object containing forecast information for a specific time period (generally 12-hour or 1-hour).\n"
      additionalProperties: false
    GridpointForecastUnits:
      enum:
      - us
      - si
      type: string
      description: Denotes the units used in the textual portions of the forecast.
      default: us
    Gridpoint12hForecastGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/Gridpoint12hForecast'
    GridpointHourlyForecastGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/GridpointHourlyForecast'
    Gridpoint12hForecastJsonLd:
      allOf:
      - $ref: '#/components/schemas/Gridpoint12hForecast'
      - required:
        - '@context'
        - geometry
        type: object
        properties:
          '@context':
            $ref: '#/components/schemas/JsonLdContext'
          geometry:
            $ref: '#/components/schemas/GeometryString'
    GridpointHourlyForecastJsonLd:
      allOf:
      - $ref: '#/components/schemas/GridpointHourlyForecast'
      - required:
        - '@context'
        - geometry
        type: object
        properties:
          '@context':
            $ref: '#/components/schemas/JsonLdContext'
          geometry:
            $ref: '#/components/schemas/GeometryString'
    ISO8601Duration:
      pattern: ^P(\d+Y)?(\d+M)?(\d+D)?(T(\d+H)?(\d+M)?(\d+S)?)?$
      type: string
      description: A time duration in ISO 8601 format.
      examples:
      - P2DT12H
    ISO8601Interval:
      oneOf:
      - pattern: ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(Z|[+-]\d{2}:?\d{2}?)|NOW)\/(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(Z|[+-]\d{2}:?\d{2}?)|NOW)$
        type: string
        examples:
        - 2007-03-01T13:00:00Z/2008-05-11T15:30:00Z
      - pattern: ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(Z|[+-]\d{2}:?\d{2}?)|NOW)\/P(\d+Y)?(\d+M)?(\d+D)?(T(\d+H)?(\d+M)?(\d+S)?)?$
        type: string
        examples:
        - 2007-03-01T13:00:00Z/P1Y2M10DT2H30M
      - pattern: ^P(\d+Y)?(\d+M)?(\d+D)?(T(\d+H)?(\d+M)?(\d+S)?)?\/(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(Z|[+-]\d{2}:?\d{2}?)|NOW)$
        type: string
        examples:
        - P1Y2M10DT2H30M/2008-05-11T15:30:00Z
      description: "A time interval in ISO 8601 format. This can be one of:\n\n    1. Start and end time\n    2. Start time and duration\n    3. Duration and end time\nThe string \"NOW\" can also be used
        in place of a start/end time.\n"
    JsonLdContext:
      anyOf:
      - type: array
        items: {}
      - type: object
    LandRegionCode:
      enum:
      - AR
      - CR
      - ER
      - PR
      - SR
      - WR
      type: string
      description: "Land region code. These correspond to the six NWS regional headquarters:\n* AR: Alaska Region\n* CR: Central Region\n* ER: Eastern Region\n* PR: Pacific Region\n* SR: Southern Region\n\
        * WR: Western Region\n"
    MarineAreaCode:
      enum:
      - AM
      - AN
      - GM
      - LC
      - LE
      - LH
      - LM
      - LO
      - LS
      - PH
      - PK
      - PM
      - PS
      - PZ
      - SL
      type: string
      description: "Marine area code as defined in NWS Directive 10-302:\n* AM: Western North Atlantic Ocean and along U.S. East Coast south of Currituck Beach Light NC following the coastline into Gulf
        of Mexico to Ocean Reef FL including the Caribbean\n* AN: Western North Atlantic Ocean and along U.S. East Coast from Canadian border south to Currituck Beach Light NC\n* GM: Gulf of Mexico and
        along the U.S. Gulf Coast from the Mexican border to Ocean Reef FL\n* LC: Lake St. Clair\n* LE: Lake Erie\n* LH: Lake Huron\n* LM: Lake Michigan\n* LO: Lake Ontario\n* LS: Lake Superior\n* PH: Central
        Pacific Ocean including Hawaiian waters\n* PK: North Pacific Ocean near Alaska and along Alaska coastline including the Bering Sea and the Gulf of Alaska\n* PM: Western Pacific Ocean including Mariana
        Island waters\n* PS: South Central Pacific Ocean including American Samoa waters\n* PZ: Eastern North Pacific Ocean and along U.S. West Coast from Canadian border to Mexican border\n* SL: St. Lawrence
        River above St. Regis\n"
    MarineRegionCode:
      enum:
      - AL
      - AT
      - GL
      - GM
      - PA
      - PI
      type: string
      description: "Marine region code. These are groups of marine areas combined.\n* AL: Alaska waters (PK)\n* AT: Atlantic Ocean (AM, AN)\n* GL: Great Lakes (LC, LE, LH, LM, LO, LS, SL)\n* GM: Gulf of
        Mexico (GM)\n* PA: Eastern Pacific Ocean and U.S. West Coast (PZ)\n* PI: Central and Western Pacific (PH, PM, PS)\n"
    MetarPhenomenon:
      required:
      - intensity
      - modifier
      - weather
      - rawString
      type: object
      properties:
        intensity:
          enum:
          - light
          - heavy
          type:
          - string
          - 'null'
        modifier:
          enum:
          - patches
          - blowing
          - low_drifting
          - freezing
          - shallow
          - partial
          - showers
          type:
          - string
          - 'null'
        weather:
          enum:
          - 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
          type: string
        rawString:
          type: string
        inVicinity:
          type: boolean
      description: An object representing a decoded METAR phenomenon string.
      additionalProperties: false
    MetarSkyCoverage:
      enum:
      - OVC
      - BKN
      - SCT
      - FEW
      - SKC
      - CLR
      - VV
      type: string
    NWSCenterWeatherServiceUnitId:
      enum:
      - ZAB
      - ZAN
      - ZAU
      - ZBW
      - ZDC
      - ZDV
      - ZFA
      - ZFW
      - ZHU
      - ZID
      - ZJX
      - ZKC
      - ZLA
      - ZLC
      - ZMA
      - ZME
      - ZMP
      - ZNY
      - ZOA
      - ZOB
      - ZSE
      - ZTL
      type: string
      description: Three-letter identifier for a Center Weather Service Unit (CWSU).
    NWSConnectDocumentMetadata:
      type: object
      properties:
        id:
          type: string
          format: uuid
        startTime:
          type: string
          description: The time when the document becomes active. ISO8601 datetime.
          format: date-time
        endTime:
          type: string
          description: The time when the document becomes inactive. ISO8601 datetime.
          format: date-time
        updateTime:
          type: string
          description: When the document was last updated. ISO8601 datetime.
          format: date-time
        title:
          maxLength: 50
          type: string
          description: A short title.
        description:
          type: string
          description: A longer description and/or caption.
        priority:
          type: boolean
          description: An indicator that a weather story should be emphasized.
        download:
          type: string
          description: The URL of the media content for the weather story.
          format: uri
      description: Metadata for an NWS Connect document.
    NWSForecastOfficeId:
      enum:
      - AKQ
      - ALY
      - BGM
      - BOX
      - BTV
      - BUF
      - CAE
      - CAR
      - CHS
      - CLE
      - CTP
      - GSP
      - GYX
      - ILM
      - ILN
      - LWX
      - MHX
      - OKX
      - PBZ
      - PHI
      - RAH
      - RLX
      - RNK
      - ABQ
      - AMA
      - BMX
      - BRO
      - CRP
      - EPZ
      - EWX
      - FFC
      - FWD
      - HGX
      - HUN
      - JAN
      - JAX
      - KEY
      - LCH
      - LIX
      - LUB
      - LZK
      - MAF
      - MEG
      - MFL
      - MLB
      - MOB
      - MRX
      - OHX
      - OUN
      - SHV
      - SJT
      - SJU
      - TAE
      - TBW
      - TSA
      - ABR
      - APX
      - ARX
      - BIS
      - BOU
      - CYS
      - DDC
      - DLH
      - DMX
      - DTX
      - DVN
      - EAX
      - FGF
      - FSD
      - GID
      - GJT
      - GLD
      - GRB
      - GRR
      - ICT
      - ILX
      - IND
      - IWX
      - JKL
      - LBF
      - LMK
      - LOT
      - LSX
      - MKX
      - MPX
      - MQT
      - OAX
      - PAH
      - PUB
      - RIW
      - SGF
      - TOP
      - UNR
      - BOI
      - BYZ
      - EKA
      - FGZ
      - GGW
      - HNX
      - LKN
      - LOX
      - MFR
      - MSO
      - MTR
      - OTX
      - PDT
      - PIH
      - PQR
      - PSR
      - REV
      - SEW
      - SGX
      - SLC
      - STO
      - TFX
      - TWC
      - VEF
      - AER
      - AFC
      - AFG
      - AJK
      - ALU
      - GUM
      - HPA
      - HFO
      - PPG
      - PQE
      - PQW
      - STU
      - NH1
      - NH2
      - ONA
      - ONP
      type: string
      description: Three-letter identifier for a NWS office.
    NWSNationalHQId:
      enum:
      - NWS
      type: string
      description: Three-letter identifier for NWS National HQ.
    NWSOfficeId:
      oneOf:
      - $ref: '#/components/schemas/NWSForecastOfficeId'
      - $ref: '#/components/schemas/NWSRegionalHQId'
      - $ref: '#/components/schemas/NWSNationalHQId'
    NWSRegionalHQId:
      enum:
      - ARH
      - CRH
      - ERH
      - PRH
      - SRH
      - WRH
      type: string
      description: Three-letter identifier for a NWS Regional HQ.
    NWSZoneID:
      pattern: ^(A[KLMNRSZ]|C[AOT]|D[CE]|F[LM]|G[AMU]|I[ADLN]|K[SY]|L[ACEHMOS]|M[ADEHINOPST]|N[CDEHJMVY]|O[HKR]|P[AHKMRSWZ]|S[CDL]|T[NX]|UT|V[AIT]|W[AIVY]|[HR]I)[CZ]\d{3}$
      type: string
      description: "UGC identifier for a NWS forecast zone or county.\nThe first two letters will correspond to either a state code or marine area code (see #/components/schemas/StateTerritoryCode and #/components/schemas/MarineAreaCode
        for lists of valid letter combinations).\nThe third letter will be Z for public/fire zone or C for county.\n"
    NWSZoneType:
      enum:
      - land
      - marine
      - forecast
      - public
      - coastal
      - offshore
      - fire
      - county
      type: string
    Observation:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        '@id':
          type: string
          format: uri
        '@type':
          enum:
          - wx:ObservationStation
          type: string
        elevation:
          $ref: '#/components/schemas/QuantitativeValue'
        station:
          type: string
          format: uri
        stationId:
          type: string
        stationName:
          type: string
        timestamp:
          type: string
          format: date-time
        rawMessage:
          type: string
        textDescription:
          type: string
        icon:
          type:
          - string
          - 'null'
          format: uri
          deprecated: true
        presentWeather:
          type: array
          items:
            $ref: '#/components/schemas/MetarPhenomenon'
        temperature:
          $ref: '#/components/schemas/QuantitativeValue'
        dewpoint:
          $ref: '#/components/schemas/QuantitativeValue'
        windDirection:
          $ref: '#/components/schemas/QuantitativeValue'
        windSpeed:
          $ref: '#/components/schemas/QuantitativeValue'
        windGust:
          $ref: '#/components/schemas/QuantitativeValue'
        barometricPressure:
          $ref: '#/components/schemas/QuantitativeValue'
        seaLevelPressure:
          $ref: '#/components/schemas/QuantitativeValue'
        visibility:
          $ref: '#/components/schemas/QuantitativeValue'
        maxTemperatureLast24Hours:
          $ref: '#/components/schemas/QuantitativeValue'
        minTemperatureLast24Hours:
          $ref: '#/components/schemas/QuantitativeValue'
        precipitationLastHour:
          $ref: '#/components/schemas/QuantitativeValue'
        precipitationLast3Hours:
          $ref: '#/components/schemas/QuantitativeValue'
        precipitationLast6Hours:
          $ref: '#/components/schemas/QuantitativeValue'
        relativeHumidity:
          $ref: '#/components/schemas/QuantitativeValue'
        windChill:
          $ref: '#/components/schemas/QuantitativeValue'
        heatIndex:
          $ref: '#/components/schemas/QuantitativeValue'
        cloudLayers:
          type:
          - array
          - 'null'
          items:
            required:
            - base
            - amount
            type: object
            properties:
              base:
                $ref: '#/components/schemas/QuantitativeValue'
              amount:
                $ref: '#/components/schemas/MetarSkyCoverage'
            additionalProperties: false
      additionalProperties: false
    ObservationGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/Observation'
    ObservationJsonLd:
      $ref: '#/components/schemas/Observation'
    ObservationCollectionGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeatureCollection'
      - type: object
        properties:
          features:
            type: array
            items:
              type: object
              properties:
                properties:
                  $ref: '#/components/schemas/Observation'
          pagination:
            $ref: '#/components/schemas/PaginationInfo'
    ObservationCollectionJsonLd:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@graph':
          type: array
          items:
            $ref: '#/components/schemas/Observation'
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
      additionalProperties: false
    ObservationStation:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        '@id':
          type: string
          format: uri
        '@type':
          enum:
          - wx:ObservationStation
          type: string
        elevation:
          $ref: '#/components/schemas/QuantitativeValue'
        stationIdentifier:
          type: string
        name:
          type: string
        timeZone:
          type: string
          format: iana-time-zone-identifier
        provider:
          type: string
          description: The data provider for this station. E.g., "ASOS," "MesoWest," etc.
        subProvider:
          type: string
          description: The sub-provider of for this station. E.g., "FAA," "DOT," etc.
        forecast:
          type: string
          description: A link to the NWS public forecast zone containing this station.
          format: uri
        county:
          type: string
          description: A link to the NWS county zone containing this station.
          format: uri
        fireWeatherZone:
          type: string
          description: A link to the NWS fire weather forecast zone containing this station.
          format: uri
        distance:
          $ref: '#/components/schemas/QuantitativeValue'
        bearing:
          $ref: '#/components/schemas/QuantitativeValue'
      additionalProperties: false
    ObservationStationGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/ObservationStation'
    ObservationStationJsonLd:
      allOf:
      - $ref: '#/components/schemas/ObservationStation'
      - required:
        - '@context'
        - geometry
        type: object
        properties:
          '@context':
            $ref: '#/components/schemas/JsonLdContext'
          geometry:
            $ref: '#/components/schemas/GeometryString'
    ObservationStationCollectionGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeatureCollection'
      - type: object
        properties:
          features:
            type: array
            items:
              type: object
              properties:
                properties:
                  $ref: '#/components/schemas/ObservationStation'
          observationStations:
            type: array
            items:
              type: string
              format: uri
          pagination:
            $ref: '#/components/schemas/PaginationInfo'
    ObservationStationCollectionJsonLd:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@graph':
          type: array
          items:
            $ref: '#/components/schemas/ObservationStation'
        observationStations:
          type: array
          items:
            type: string
            format: uri
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
      additionalProperties: false
    Office:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@type':
          enum:
          - GovernmentOrganization
          type: string
        '@id':
          type: string
          format: uri
        id:
          type: string
        name:
          type: string
        address:
          type: object
          properties:
            '@type':
              enum:
              - PostalAddress
              type: string
            streetAddress:
              type: string
            addressLocality:
              type: string
            addressRegion:
              type: string
            postalCode:
              type: string
          additionalProperties: false
        telephone:
          type: string
        faxNumber:
          type: string
        email:
          type: string
        sameAs:
          type: string
          format: uri
        nwsRegion:
          type: string
        parentOrganization:
          type: string
          format: uri
        responsibleCounties:
          type: array
          items:
            type: string
            format: uri
        responsibleForecastZones:
          type: array
          items:
            type: string
            format: uri
        responsibleFireZones:
          type: array
          items:
            type: string
            format: uri
        approvedObservationStations:
          type: array
          items:
            type: string
            format: uri
      additionalProperties: false
    OfficeBriefing:
      $ref: '#/components/schemas/NWSConnectDocumentMetadata'
    OfficeHeadline:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@id':
          type: string
          format: uri
        id:
          type: string
        office:
          type: string
          format: uri
        important:
          type: boolean
        issuanceTime:
          type: string
          format: date-time
        link:
          type: string
          format: uri
        name:
          type: string
        title:
          type: string
        summary:
          type:
          - string
          - 'null'
        content:
          type: string
    OfficeHeadlineCollection:
      required:
      - '@context'
      - '@graph'
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@graph':
          type: array
          items:
            $ref: '#/components/schemas/OfficeHeadline'
      additionalProperties: false
    OfficeWeatherStory:
      required:
      - startTime
      - endTime
      - updateTime
      - title
      - description
      - altText
      - priority
      - order
      - download
      allOf:
      - $ref: '#/components/schemas/NWSConnectDocumentMetadata'
      - type: object
        properties:
          altText:
            type: string
            description: Alternative text description of the content of the image for assistive technology.
          order:
            maximum: 7
            minimum: 1
            type: integer
            description: The order in which a weather story should be displayed. Unique for each object.
    OfficeWeatherStoryCollection:
      type: array
      items:
        $ref: '#/components/schemas/OfficeWeatherStory'
    PaginationInfo:
      required:
      - next
      type: object
      properties:
        next:
          type: string
          description: A link to the next page of records
          format: uri
      description: Links for retrieving more data from paged data sets
      additionalProperties: false
    Point:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        '@id':
          type: string
          format: uri
        '@type':
          enum:
          - wx:Point
          type: string
        cwa:
          $ref: '#/components/schemas/NWSForecastOfficeId'
        type:
          enum:
          - land
          - marine
          type: string
          description: Whether the specific point is on land or marine
        forecastOffice:
          type: string
          format: uri
        gridId:
          $ref: '#/components/schemas/NWSForecastOfficeId'
        gridX:
          minimum: 0
          type: integer
        gridY:
          minimum: 0
          type: integer
        forecast:
          type: string
          format: uri
        forecastHourly:
          type: string
          format: uri
        forecastGridData:
          type: string
          format: uri
        observationStations:
          type: string
          format: uri
        relativeLocation:
          oneOf:
          - $ref: '#/components/schemas/RelativeLocationGeoJson'
          - $ref: '#/components/schemas/RelativeLocationJsonLd'
        forecastZone:
          type: string
          format: uri
        county:
          type: string
          format: uri
        fireWeatherZone:
          type: string
          format: uri
        timeZone:
          type: string
        radarStation:
          type: string
        astronomicalData:
          $ref: '#/components/schemas/AstronomicalData'
        nwr:
          type: object
          properties:
            transmitter:
              type:
              - string
              - 'null'
              description: Transmitter callsign
            sameCode:
              type: string
              description: The SAME code of this point's county
            areaBroadcast:
              type:
              - string
              - 'null'
              description: A link to the area NWR broadcast from this transmitter
              format: uri
            pointBroadcast:
              type:
              - string
              - 'null'
              description: A link to the local NWR broadcast for this point
              format: uri
          description: NOAA Weather Radio metadata for this point
    PointGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/Point'
    PointJsonLd:
      allOf:
      - $ref: '#/components/schemas/Point'
      - required:
        - '@context'
        - geometry
        type: object
        properties:
          '@context':
            $ref: '#/components/schemas/JsonLdContext'
          geometry:
            $ref: '#/components/schemas/GeometryString'
    PointString:
      pattern: ^(-?\d+(?:\.\d+)?),(-?\d+(?:\.\d+)?)$
      type: string
    ProblemDetail:
      required:
      - type
      - title
      - status
      - detail
      - instance
      - correlationId
      type: object
      properties:
        type:
          type: string
          description: "A URI reference (RFC 3986) that identifies the problem type. This is only an identifier and is not necessarily a resolvable URL.\n"
          format: uri
          default: about:blank
          examples:
          - urn:noaa:nws:api:UnexpectedProblem
        title:
          type: string
          description: A short, human-readable summary of the problem type.
          examples:
          - Unexpected Problem
        status:
          maximum: 999
          minimum: 100
          type: number
          description: "The HTTP status code (RFC 7231, Section 6) generated by the origin server for this occurrence of the problem.\n"
          examples:
          - 500
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
          - An unexpected problem has occurred.
        instance:
          type: string
          description: "A URI reference (RFC 3986) that identifies the specific occurrence of the problem. This is only an identifier and is not necessarily a resolvable URL.\n"
          format: uri
          examples:
          - urn:noaa:nws:api:request:493c3a1d-f87e-407f-ae2c-24483f5aab63
        correlationId:
          type: string
          description: "A unique identifier for the request, used for NWS debugging purposes. Please include this identifier with any correspondence to help us investigate your issue.\n"
          examples:
          - 493c3a1d-f87e-407f-ae2c-24483f5aab63
      description: Detail about an error. This document conforms to RFC 7807 (Problem Details for HTTP APIs).
      additionalProperties: true
    QuantitativeValue:
      type: object
      properties:
        value:
          type:
          - number
          - 'null'
          description: A measured value
        maxValue:
          type: number
          description: The maximum value of a range of measured values
        minValue:
          type: number
          description: The minimum value of a range of measured values
        unitCode:
          $ref: '#/components/schemas/UnitOfMeasure'
        qualityControl:
          enum:
          - Z
          - C
          - S
          - V
          - X
          - Q
          - G
          - B
          - T
          type: string
          description: "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\n"
      description: "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\n"
      additionalProperties: false
    RegionCode:
      oneOf:
      - $ref: '#/components/schemas/LandRegionCode'
      - $ref: '#/components/schemas/MarineRegionCode'
    RelativeLocation:
      type: object
      properties:
        city:
          type: string
        state:
          type: string
        distance:
          $ref: '#/components/schemas/QuantitativeValue'
        bearing:
          $ref: '#/components/schemas/QuantitativeValue'
    RelativeLocationGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/RelativeLocation'
    RelativeLocationJsonLd:
      allOf:
      - $ref: '#/components/schemas/RelativeLocation'
      - required:
        - geometry
        type: object
        properties:
          geometry:
            $ref: '#/components/schemas/GeometryString'
    Sigmet:
      type: object
      properties:
        id:
          type: string
          format: uri
        issueTime:
          type: string
          format: date-time
        fir:
          type:
          - string
          - 'null'
        atsu:
          $ref: '#/components/schemas/ATSUIdentifier'
        sequence:
          type:
          - string
          - 'null'
        phenomenon:
          type:
          - string
          - 'null'
          format: uri
        start:
          type: string
          format: date-time
        end:
          type: string
          format: date-time
      additionalProperties: false
    SigmetCollectionGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeatureCollection'
      - type: object
        properties:
          features:
            type: array
            items:
              $ref: '#/components/schemas/SigmetGeoJson'
    SigmetGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/Sigmet'
    SigmetSequenceNumber:
      type: string
    StateTerritoryCode:
      enum:
      - AL
      - AK
      - AS
      - AR
      - AZ
      - CA
      - CO
      - CT
      - DE
      - DC
      - FL
      - GA
      - GU
      - HI
      - ID
      - IL
      - IN
      - IA
      - KS
      - KY
      - LA
      - ME
      - MD
      - MA
      - MI
      - MN
      - MS
      - MO
      - MT
      - NE
      - NV
      - NH
      - NJ
      - NM
      - NY
      - NC
      - ND
      - OH
      - OK
      - OR
      - PA
      - PR
      - RI
      - SC
      - SD
      - TN
      - TX
      - UT
      - VT
      - VI
      - VA
      - WA
      - WV
      - WI
      - WY
      - MP
      - PW
      - FM
      - MH
      type: string
    TextProduct:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@id':
          type: string
          format: uri
        id:
          type: string
        wmoCollectiveId:
          type: string
        issuingOffice:
          type: string
        issuanceTime:
          type: string
          format: date-time
        productCode:
          type: string
        productName:
          type: string
        productText:
          type: string
      additionalProperties: false
    TextProductCollection:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@graph':
          type: array
          items:
            $ref: '#/components/schemas/TextProduct'
      additionalProperties: false
    TextProductTypeCollection:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@graph':
          type: array
          items:
            required:
            - productCode
            - productName
            type: object
            properties:
              productCode:
                type: string
              productName:
                type: string
            additionalProperties: false
      additionalProperties: false
    TextProductLocationCollection:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        locations:
          type: object
          additionalProperties:
            type:
            - string
            - 'null'
      additionalProperties: false
    Time:
      pattern: ^([01][0-9]|2[0-3])[0-5][0-9]$
      type: string
      description: A time (in HHMM format). This is always specified in UTC (Zulu) time.
    UnitOfMeasure:
      pattern: ^((wmo|uc|wmoUnit|nwsUnit):)?.*$
      type: string
      description: "A string denoting a unit of measure, expressed in the format \"{unit}\" or \"{namespace}:{unit}\".\nUnits 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}.\nUnits with the namespace \"nwsUnit\" are currently
        custom and do not align to any standard.\nUnits 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).\nNamespaced units are considered
        deprecated. We will be aligning API to use the same standards as GML/IWXXM in the future.\n"
    Zone:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        '@id':
          type: string
          format: uri
        '@type':
          enum:
          - wx:Zone
          type: string
        id:
          $ref: '#/components/schemas/NWSZoneID'
        type:
          $ref: '#/components/schemas/NWSZoneType'
        name:
          type: string
        effectiveDate:
          type: string
          format: date-time
        expirationDate:
          type: string
          format: date-time
        state:
          oneOf:
          - $ref: '#/components/schemas/StateTerritoryCode'
          - enum:
            - ''
            type: string
          - type: 'null'
        forecastOffice:
          type: string
          format: uri
        gridIdentifier:
          type: string
        awipsLocationIdentifier:
          type: string
        cwa:
          type: array
          items:
            $ref: '#/components/schemas/NWSForecastOfficeId'
          deprecated: true
        forecastOffices:
          type: array
          items:
            type: string
            format: uri
          deprecated: true
        timeZone:
          type: array
          items:
            type: string
            format: iana-time-zone-identifier
        observationStations:
          type: array
          items:
            type: string
            format: uri
        radarStation:
          type:
          - string
          - 'null'
      additionalProperties: false
    ZoneGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/Zone'
    ZoneJsonLd:
      $ref: '#/components/schemas/Zone'
    ZoneCollectionGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeatureCollection'
      - type: object
        properties:
          features:
            type: array
            items:
              type: object
              properties:
                properties:
                  $ref: '#/components/schemas/Zone'
    ZoneCollectionJsonLd:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        '@graph':
          type: array
          items:
            $ref: '#/components/schemas/Zone'
      additionalProperties: false
    ZoneForecast:
      type: object
      properties:
        '@context':
          $ref: '#/components/schemas/JsonLdContext'
        geometry:
          $ref: '#/components/schemas/GeometryString'
        zone:
          type: string
          description: An API link to the zone this forecast is for.
          format: uri
        updated:
          type: string
          description: The time this zone forecast product was published.
          format: date-time
        periods:
          type: array
          items:
            required:
            - number
            - name
            - detailedForecast
            type: object
            properties:
              number:
                type: integer
                description: A sequential identifier number.
              name:
                type: string
                description: A textual description of the period.
                examples:
                - This Afternoon
              detailedForecast:
                type: string
                description: A detailed textual forecast for the period.
            additionalProperties: false
          description: An array of forecast periods.
      description: An object representing a zone area forecast.
      additionalProperties: false
    ZoneForecastGeoJson:
      allOf:
      - $ref: '#/components/schemas/GeoJsonFeature'
      - type: object
        properties:
          properties:
            $ref: '#/components/schemas/ZoneForecast'
    ZoneForecastJsonLd:
      $ref: '#/components/schemas/ZoneForecast'
  responses:
    AlertCollection:
      description: A collection of alerts.
      headers:
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationId'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        X-Server-Id:
          $ref: '#/components/headers/ServerId'
      content:
        application/geo+json:
          schema:
            $ref: '#/components/schemas/AlertCollectionGeoJson'
        application/ld+json:
          schema:
            $ref: '#/components/schemas/AlertCollectionJsonLd'
        application/atom+xml:
          schema:
            $ref: '#/components/schemas/AlertAtomFeed'
      x-url-content-negotiation-extensions:
        json: application/geo+json
        atom: application/atom+xml
    Error:
      description: An error response.
      headers:
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationId'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        X-Server-Id:
          $ref: '#/components/headers/ServerId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetail'
    Gridpoint12hForecast:
      description: A forecast for a gridpoint.
      headers:
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationId'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        X-Server-Id:
          $ref: '#/components/headers/ServerId'
      content:
        application/geo+json:
          schema:
            $ref: '#/components/schemas/Gridpoint12hForecastGeoJson'
        application/ld+json:
          schema:
            $ref: '#/components/schemas/Gridpoint12hForecastJsonLd'
        application/vnd.noaa.dwml+xml:
          schema: {}
    GridpointHourlyForecast:
      description: A forecast for a gridpoint.
      headers:
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationId'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        X-Server-Id:
          $ref: '#/components/headers/ServerId'
      content:
        application/geo+json:
          schema:
            $ref: '#/components/schemas/GridpointHourlyForecastGeoJson'
        application/ld+json:
          schema:
            $ref: '#/components/schemas/GridpointHourlyForecastJsonLd'
        application/vnd.noaa.dwml+xml:
          schema: {}
    Observation:
      description: An observation record.
      headers:
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationId'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        X-Server-Id:
          $ref: '#/components/headers/ServerId'
      content:
        application/geo+json:
          schema:
            $ref: '#/components/schemas/ObservationGeoJson'
        application/ld+json:
          schema:
            $ref: '#/components/schemas/ObservationJsonLd'
        application/vnd.noaa.uswx+xml:
          schema: {}
        application/vnd.noaa.obs+xml:
          schema: {}
    ObservationCollection:
      description: A collection of observation records.
      headers:
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationId'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        X-Server-Id:
          $ref: '#/components/headers/ServerId'
      content:
        application/geo+json:
          schema:
            $ref: '#/components/schemas/ObservationCollectionGeoJson'
        application/ld+json:
          schema:
            $ref: '#/components/schemas/ObservationCollectionJsonLd'
    ObservationStationCollection:
      description: A collection of observation stations.
      headers:
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationId'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
        X-Server-Id:
          $ref: '#/components/headers/ServerId'
      content:
        application/geo+json:
          schema:
            $ref: '#/components/schemas/ObservationStationCollectionGeoJson'
        application/ld+json:
          schema:
            $ref: '#/components/schemas/ObservationStationCollectionJsonLd'
  parameters:
    AlertArea:
      name: area
      in: query
      description: "State/territory code or marine area code\nThis parameter is incompatible with the following parameters: point, region, region_type, zone\n"
      style: form
      explode: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/AreaCode'
    AlertCertainty:
      name: certainty
      in: query
      description: Certainty (observed, likely, possible, unlikely, unknown)
      style: form
      explode: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/AlertCertainty'
    AlertCode:
      name: code
      in: query
      description: Event code
      style: form
      explode: false
      schema:
        type: array
        items:
          pattern: ^\w{3}$
          type: string
    AlertEventName:
      name: event
      in: query
      description: Event name
      style: form
      explode: false
      schema:
        type: array
        items:
          pattern: ^[A-Za-z0-9 ]+$
          type: string
    AlertMessageType:
      name: message_type
      in: query
      description: Message type (alert, update, cancel)
      style: form
      explode: false
      schema:
        type: array
        items:
          enum:
          - alert
          - update
          - cancel
          type: string
    AlertPoint:
      name: point
      in: query
      description: "Point (latitude,longitude)\nThis parameter is incompatible with the following parameters: area, region, region_type, zone\n"
      schema:
        $ref: '#/components/schemas/PointString'
    AlertRegion:
      name: region
      in: query
      description: "Marine region code\nThis parameter is incompatible with the following parameters: area, point, region_type, zone\n"
      style: form
      explode: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/MarineRegionCode'
    AlertRegionType:
      name: region_type
      in: query
      description: "Region type (land or marine)\nThis parameter is incompatible with the following parameters: area, point, region, zone\n"
      schema:
        enum:
        - land
        - marine
        type: string
    AlertSeverity:
      name: severity
      in: query
      description: Severity (extreme, severe, moderate, minor, unknown)
      style: form
      explode: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/AlertSeverity'
    AlertStatus:
      name: status
      in: query
      description: Status (actual, exercise, system, test, draft)
      style: form
      explode: false
      schema:
        type: array
        items:
          enum:
          - actual
          - exercise
          - system
          - test
          - draft
          type: string
    AlertUrgency:
      name: urgency
      in: query
      description: Urgency (immediate, expected, future, past, unknown)
      style: form
      explode: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/AlertUrgency'
    AlertZone:
      name: zone
      in: query
      description: "Zone ID (forecast or county)\nThis parameter is incompatible with the following parameters: area, point, region, region_type\n"
      style: form
      explode: false
      schema:
        type: array
        items:
          $ref: '#/components/schemas/NWSZoneID'
    ATSUIdentifier:
      name: atsu
      in: path
      description: ATSU identifier
      required: true
      schema:
        $ref: '#/components/schemas/ATSUIdentifier'
    CallSign:
      name: callSign
      in: path
      description: The call sign identifier for a NOAA transmitter station.
      required: true
      schema:
        type: string
    Date:
      name: date
      in: path
      description: Date (YYYY-MM-DD format)
      required: true
      schema:
        $ref: '#/components/schemas/Date'
    GridpointForecastFeatureFlags:
      name: Feature-Flags
      in: header
      description: "Enable future and experimental features (see documentation for more info):\n* forecast_temperature_qv: Represent temperature as QuantitativeValue\n* forecast_wind_speed_qv: Represent
        wind speed as QuantitativeValue\n"
      required: false
      style: simple
      explode: false
      schema:
        type: array
        items:
          enum:
          - forecast_temperature_qv
          - forecast_wind_speed_qv
          type: string
    GridpointForecastUnits:
      name: units
      in: query
      description: Use US customary or SI (metric) units in textual output
      schema:
        $ref: '#/components/schemas/GridpointForecastUnits'
    GridpointWFO:
      name: wfo
      in: path
      description: Forecast office ID
      required: true
      schema:
        $ref: '#/components/schemas/NWSForecastOfficeId'
    GridpointX:
      name: x
      in: path
      description: Forecast grid X coordinate
      required: true
      schema:
        minimum: 0
        type: integer
    GridpointY:
      name: y
      in: path
      description: Forecast grid Y coordinate
      required: true
      schema:
        minimum: 0
        type: integer
    Latitude:
      name: latitude
      in: path
      description: Latitude
      required: true
      schema:
        multipleOf: 0.0001
        maximum: 90
        minimum: -90
        type: number
    Longitude:
      name: longitude
      in: path
      description: Longitude
      required: true
      schema:
        multipleOf: 0.0001
        maximum: 180
        minimum: -180
        type: number
    Limit:
      name: limit
      in: query
      description: Limit
      schema:
        maximum: 500
        minimum: 1
        type: integer
        default: 500
    NWSCenterWeatherServiceUnitId:
      name: cwsuId
      in: path
      description: NWS CWSU ID
      required: true
      schema:
        $ref: '#/components/schemas/NWSCenterWeatherServiceUnitId'
    NWSOfficeId:
      name: officeId
      in: path
      description: NWS office ID
      required: true
      schema:
        $ref: '#/components/schemas/NWSOfficeId'
    NWSZoneId:
      name: zoneId
      in: path
      description: NWS public zone/county identifier
      required: true
      schema:
        $ref: '#/components/schemas/NWSZoneID'
    ObservationStationId:
      name: stationId
      in: path
      description: Observation station ID
      required: true
      schema:
        type: string
    PaginationCursor:
      name: cursor
      in: query
      description: Pagination cursor
      schema:
        type: string
    QueryDate:
      name: date
      in: query
      description: Date (YYYY-MM-DD format)
      schema:
        $ref: '#/components/schemas/Date'
    QueryStartTime:
      name: start
      in: query
      description: Start time
      schema:
        type: string
        format: date-time
    QueryEndTime:
      name: end
      in: query
      description: End time
      schema:
        type: string
        format: date-time
    SigmetSequenceNumber:
      name: sequence
      in: path
      description: SIGMET sequence number
      required: true
      schema:
        $ref: '#/components/schemas/SigmetSequenceNumber'
    Time:
      name: time
      in: path
      description: Time (HHMM format). This time is always specified in UTC (Zulu) time.
      required: true
      schema:
        $ref: '#/components/schemas/Time'
  headers:
    CorrelationId:
      description: "A unique identifier for the request, used for NWS debugging purposes. Please include this identifier with any correspondence to help us investigate your issue.\n"
      schema:
        type: string
    RequestId:
      description: "A unique identifier for the request, used for NWS debugging purposes. Please include this identifier with any correspondence to help us investigate your issue.\n"
      schema:
        type: string
    ServerId:
      description: "The identifier of the server that generated the response, used for NWS debugging purposes. Please include this identifier with any correspondence to help us investigate your issue.\n"
      schema:
        type: string
    X-Api-Key:
      description: "A token that a client provides when making API calls.  Please include this identifier with any correspondence to help us investigate your issue.\n"
      schema:
        type: string
  securitySchemes:
    userAgent:
      type: apiKey
      description: "We require that all consumers of the API include a User-Agent header in requests. This is due to a high number of scripts exhibiting abusive behavior (intentional or unintentional).
        We recommend setting the value to something that identifies your application and includes a contact email. This will help us contact you if we notice unusual behavior and also aid in troubleshooting
        issues.\nThe API remains open and free to use and there are no limits imposed based on the User-Agent string.\nThis mechanism will be replaced with a more typical API key system at a later date.\n"
      name: User-Agent
      in: header
    apiKeyAuth:
      type: apiKey
      description: "We are testing including a more traditional API Key system on certain endpoints.  This is due to a large change in the weather.gov site.\nThe API remains open and free to use and there
        are no limits imposed based on the X-Api-Key string.\n"
      name: API-Key
      in: header
security:
- userAgent: []
- apiKeyAuth: []
externalDocs:
  description: Full API documentation
  url: https://www.weather.gov/documentation/services-web-api