---
title: "GET Observations-History-stationId"
url: "https://developers.perryweather.com/apis/perry-weather-api-1/versions/7110667a-0eb5-4377-b3c7-1dbf5b442cbb/paths/Observations-History-stationId/get"
---

> Full API specification: https://developers.perryweather.com/apis/perry-weather-api-1/versions/7110667a-0eb5-4377-b3c7-1dbf5b442cbb.md

# /Observations/History/{stationId}

`GET` `/Observations/History/{stationId}`

**Time frame limits by dataset:** - `minutely`: Maximum **2 days** of data - `hourly`: Maximum **7 days** of data - `daily`: Maximum **93 days** (3 months) of data > **Note**: Exceeding these limits will return an error. **Response shape varies by dataset:** - `minutely` and `hourly` → `result` is an array of `ObservationModel` (ambient temperature, humidity, wind, etc. as point-in-time readings). - `daily` → `result` is an array of `DailyObservationModel` with max/min/avg aggregates instead of point-in-time fields.

## Path parameters

- `stationId` (string, required) - The weather station identifier.

## Query parameters

- `dataset` (string, optional) - The data granularity: minutely, hourly, or daily.
- `date` (string, date-time, optional) - The start date for the time range.
- `span` (integer, int32, optional) - The number of minutes, hours, or days to include (interpretation depends on dataset).

## Header parameters

- `x-api-key` (string, required) - API key for authenticating requests. Create and manage keys in the Perry Weather dashboard under Integrations > Perry Weather APIs.

## Responses

- `200` - Success
- `400` - Bad Request
- `404` - Not Found

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Perry Weather API
  version: "1.0"
servers:
  - url: https://customer.api.perryweather.com/v1/
    description: Production Server
paths:
  /Observations/History/{stationId}:
    get:
      tags:
        - Observations
      description: "**Time frame limits by dataset:**\r

        \            \r

        - `minutely`: Maximum **2 days** of data\r

        - `hourly`: Maximum **7 days** of data\r

        - `daily`: Maximum **93 days** (3 months) of data\r

        \            \r

        > **Note**: Exceeding these limits will return an error.\r

        \            \r

        **Response shape varies by dataset:**\r

        \            \r

        - `minutely` and `hourly` → `result` is an array of `ObservationModel`\r

        \  (ambient temperature, humidity, wind, etc. as point-in-time
        readings).\r

        - `daily` → `result` is an array of `DailyObservationModel` with\r

        \  max/min/avg aggregates instead of point-in-time fields."
      parameters:
        - name: x-api-key
          in: header
          description: API key for authenticating requests. Create and manage keys in the
            Perry Weather dashboard under Integrations > Perry Weather APIs.
          required: true
          schema:
            type: string
            example: YOUR-API-KEY
        - name: stationId
          in: path
          description: The weather station identifier.
          required: true
          schema:
            type: string
        - name: dataset
          in: query
          description: "The data granularity: minutely, hourly, or daily."
          schema:
            type: string
        - name: date
          in: query
          description: The start date for the time range.
          schema:
            type: string
            format: date-time
        - name: span
          in: query
          description: The number of minutes, hours, or days to include (interpretation
            depends on dataset).
          schema:
            type: integer
            format: int32
      responses:
        "200":
          description: Success
          content:
            text/plain:
              schema:
                oneOf:
                  - title: ObservationModel[] — minutely / hourly
                    type: array
                    items:
                      $ref: "#/components/schemas/ObservationModel"
                  - title: DailyObservationModel[] — daily
                    type: array
                    items:
                      $ref: "#/components/schemas/DailyObservationModel"
              examples:
                minutely:
                  summary: dataset=minutely — 5-minute interval ObservationModel entries
                  value:
                    - lastUpdated: 2026-04-01T12:00:00Z
                      ambientTemperature:
                        value: 76.42
                        unit: F
                        display: 76.42F
                      relativeHumidity:
                        value: 57.33
                        unit: "%"
                        display: 57.33%
                      windSpeed:
                        value: 4.6312
                        unit: mph
                        display: 4.6312mph
                      windDirection: 182.5
                      windGust:
                        value: 11.0287
                        unit: mph
                        display: 11.0287mph
                      windGustDirection: 182.5
                      wetBulb:
                        value: 63.512
                        unit: F
                        display: 63.512F
                      wetBulbGlobalTemp:
                        value: 68.714
                        unit: F
                        display: 68.714F
                      ambientHigh:
                        value: 76.9
                        unit: F
                        display: 76.9F
                      ambientLow:
                        value: 76.1
                        unit: F
                        display: 76.1F
                      heatIndex:
                        value: 76.8534
                        unit: F
                        display: 76.8534F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0.0123
                        unit: in
                        display: 0.0123in
                      aqiVal:
                        value: 31
                        unit: PM2.5
                        display: 31PM2.5
                      feelsLike:
                        value: 76.42
                        unit: F
                        display: 76.42F
                    - lastUpdated: 2026-04-01T12:05:00Z
                      ambientTemperature:
                        value: 76.88
                        unit: F
                        display: 76.88F
                      relativeHumidity:
                        value: 56.91
                        unit: "%"
                        display: 56.91%
                      windSpeed:
                        value: 5.0129
                        unit: mph
                        display: 5.0129mph
                      windDirection: 186.25
                      windGust:
                        value: 11.6831
                        unit: mph
                        display: 11.6831mph
                      windGustDirection: 186.25
                      wetBulb:
                        value: 63.881
                        unit: F
                        display: 63.881F
                      wetBulbGlobalTemp:
                        value: 69.043
                        unit: F
                        display: 69.043F
                      ambientHigh:
                        value: 77.2
                        unit: F
                        display: 77.2F
                      ambientLow:
                        value: 76.4
                        unit: F
                        display: 76.4F
                      heatIndex:
                        value: 77.241
                        unit: F
                        display: 77.241F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0.0123
                        unit: in
                        display: 0.0123in
                      aqiVal:
                        value: 32
                        unit: PM2.5
                        display: 32PM2.5
                      feelsLike:
                        value: 76.88
                        unit: F
                        display: 76.88F
                hourly:
                  summary: dataset=hourly — hourly ObservationModel entries
                  value:
                    - lastUpdated: 2026-04-01T00:00:00Z
                      ambientTemperature:
                        value: 82.15
                        unit: F
                        display: 82.15F
                      relativeHumidity:
                        value: 46.25
                        unit: "%"
                        display: 46.25%
                      windSpeed:
                        value: 7.5432
                        unit: mph
                        display: 7.5432mph
                      windDirection: 165.33
                      windGust:
                        value: 18.7218
                        unit: mph
                        display: 18.7218mph
                      windGustDirection: 165.33
                      wetBulb:
                        value: 67.124
                        unit: F
                        display: 67.124F
                      wetBulbGlobalTemp:
                        value: 73.612
                        unit: F
                        display: 73.612F
                      ambientHigh:
                        value: 84.7
                        unit: F
                        display: 84.7F
                      ambientLow:
                        value: 80.1
                        unit: F
                        display: 80.1F
                      heatIndex:
                        value: 82.4217
                        unit: F
                        display: 82.4217F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 27
                        unit: PM2.5
                        display: 27PM2.5
                      feelsLike:
                        value: 82.4217
                        unit: F
                        display: 82.4217F
                    - lastUpdated: 2026-04-01T01:00:00Z
                      ambientTemperature:
                        value: 79.12
                        unit: F
                        display: 79.12F
                      relativeHumidity:
                        value: 51.08
                        unit: "%"
                        display: 51.08%
                      windSpeed:
                        value: 3.1472
                        unit: mph
                        display: 3.1472mph
                      windDirection: 158.67
                      windGust:
                        value: 8.4125
                        unit: mph
                        display: 8.4125mph
                      windGustDirection: 158.67
                      wetBulb:
                        value: 65.923
                        unit: F
                        display: 65.923F
                      wetBulbGlobalTemp:
                        value: 71.218
                        unit: F
                        display: 71.218F
                      ambientHigh:
                        value: 80.9
                        unit: F
                        display: 80.9F
                      ambientLow:
                        value: 78.6
                        unit: F
                        display: 78.6F
                      heatIndex:
                        value: 79.1126
                        unit: F
                        display: 79.1126F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 33
                        unit: PM2.5
                        display: 33PM2.5
                      feelsLike:
                        value: 79.12
                        unit: F
                        display: 79.12F
                    - lastUpdated: 2026-04-01T02:00:00Z
                      ambientTemperature:
                        value: 77.83
                        unit: F
                        display: 77.83F
                      relativeHumidity:
                        value: 55.42
                        unit: "%"
                        display: 55.42%
                      windSpeed:
                        value: 4.8125
                        unit: mph
                        display: 4.8125mph
                      windDirection: 152.42
                      windGust:
                        value: 13.9213
                        unit: mph
                        display: 13.9213mph
                      windGustDirection: 152.42
                      wetBulb:
                        value: 66.423
                        unit: F
                        display: 66.423F
                      wetBulbGlobalTemp:
                        value: 71.512
                        unit: F
                        display: 71.512F
                      ambientHigh:
                        value: 79.2
                        unit: F
                        display: 79.2F
                      ambientLow:
                        value: 76.8
                        unit: F
                        display: 76.8F
                      heatIndex:
                        value: 77.8291
                        unit: F
                        display: 77.8291F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 36
                        unit: PM2.5
                        display: 36PM2.5
                      feelsLike:
                        value: 77.83
                        unit: F
                        display: 77.83F
                    - lastUpdated: 2026-04-01T03:00:00Z
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 34
                        unit: PM2.5
                        display: 34PM2.5
                daily:
                  summary: dataset=daily — DailyObservationModel entries (different shape)
                  value:
                    - lastUpdated: 2026-04-01T00:00:00Z
                      maxAmbientTemperature:
                        value: 84.6
                        unit: F
                        display: 84.6F
                      minAmbientTemperature:
                        value: 61.3
                        unit: F
                        display: 61.3F
                      avgAmbientTemperature:
                        value: 72.8
                        unit: F
                        display: 72.8F
                      relativeHumidity:
                        value: 58.12
                        unit: "%"
                        display: 58.12%
                      windSpeed:
                        value: 5.1728
                        unit: mph
                        display: 5.1728mph
                      windGust:
                        value: 14.6213
                        unit: mph
                        display: 14.6213mph
                      windDirection: 172.5
                      maxWetBulbGlobeTemp:
                        value: 76.9
                        unit: F
                        display: 76.9F
                      minWetBulbGlobeTemp:
                        value: 63.8
                        unit: F
                        display: 63.8F
                      heatIndex:
                        value: 82.4
                        unit: F
                        display: 82.4F
                      rainTotal:
                        value: 0.0134
                        unit: in
                        display: 0.0134in
                      aqiVal:
                        value: 31
                        unit: PM2.5
                        display: 31PM2.5
                    - lastUpdated: 2026-04-02T00:00:00Z
                      maxAmbientTemperature:
                        value: 81.9
                        unit: F
                        display: 81.9F
                      minAmbientTemperature:
                        value: 59.7
                        unit: F
                        display: 59.7F
                      avgAmbientTemperature:
                        value: 70.2
                        unit: F
                        display: 70.2F
                      relativeHumidity:
                        value: 62.41
                        unit: "%"
                        display: 62.41%
                      windSpeed:
                        value: 6.3921
                        unit: mph
                        display: 6.3921mph
                      windGust:
                        value: 17.1128
                        unit: mph
                        display: 17.1128mph
                      windDirection: 188.25
                      maxWetBulbGlobeTemp:
                        value: 74.3
                        unit: F
                        display: 74.3F
                      minWetBulbGlobeTemp:
                        value: 62.4
                        unit: F
                        display: 62.4F
                      heatIndex:
                        value: 79.8
                        unit: F
                        display: 79.8F
                      rainTotal:
                        value: 0.2451
                        unit: in
                        display: 0.2451in
                      aqiVal:
                        value: 28
                        unit: PM2.5
                        display: 28PM2.5
            application/json:
              schema:
                oneOf:
                  - title: ObservationModel[] — minutely / hourly
                    type: array
                    items:
                      $ref: "#/components/schemas/ObservationModel"
                  - title: DailyObservationModel[] — daily
                    type: array
                    items:
                      $ref: "#/components/schemas/DailyObservationModel"
              examples:
                minutely:
                  summary: dataset=minutely — 5-minute interval ObservationModel entries
                  value:
                    - lastUpdated: 2026-04-01T12:00:00Z
                      ambientTemperature:
                        value: 76.42
                        unit: F
                        display: 76.42F
                      relativeHumidity:
                        value: 57.33
                        unit: "%"
                        display: 57.33%
                      windSpeed:
                        value: 4.6312
                        unit: mph
                        display: 4.6312mph
                      windDirection: 182.5
                      windGust:
                        value: 11.0287
                        unit: mph
                        display: 11.0287mph
                      windGustDirection: 182.5
                      wetBulb:
                        value: 63.512
                        unit: F
                        display: 63.512F
                      wetBulbGlobalTemp:
                        value: 68.714
                        unit: F
                        display: 68.714F
                      ambientHigh:
                        value: 76.9
                        unit: F
                        display: 76.9F
                      ambientLow:
                        value: 76.1
                        unit: F
                        display: 76.1F
                      heatIndex:
                        value: 76.8534
                        unit: F
                        display: 76.8534F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0.0123
                        unit: in
                        display: 0.0123in
                      aqiVal:
                        value: 31
                        unit: PM2.5
                        display: 31PM2.5
                      feelsLike:
                        value: 76.42
                        unit: F
                        display: 76.42F
                    - lastUpdated: 2026-04-01T12:05:00Z
                      ambientTemperature:
                        value: 76.88
                        unit: F
                        display: 76.88F
                      relativeHumidity:
                        value: 56.91
                        unit: "%"
                        display: 56.91%
                      windSpeed:
                        value: 5.0129
                        unit: mph
                        display: 5.0129mph
                      windDirection: 186.25
                      windGust:
                        value: 11.6831
                        unit: mph
                        display: 11.6831mph
                      windGustDirection: 186.25
                      wetBulb:
                        value: 63.881
                        unit: F
                        display: 63.881F
                      wetBulbGlobalTemp:
                        value: 69.043
                        unit: F
                        display: 69.043F
                      ambientHigh:
                        value: 77.2
                        unit: F
                        display: 77.2F
                      ambientLow:
                        value: 76.4
                        unit: F
                        display: 76.4F
                      heatIndex:
                        value: 77.241
                        unit: F
                        display: 77.241F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0.0123
                        unit: in
                        display: 0.0123in
                      aqiVal:
                        value: 32
                        unit: PM2.5
                        display: 32PM2.5
                      feelsLike:
                        value: 76.88
                        unit: F
                        display: 76.88F
                hourly:
                  summary: dataset=hourly — hourly ObservationModel entries
                  value:
                    - lastUpdated: 2026-04-01T00:00:00Z
                      ambientTemperature:
                        value: 82.15
                        unit: F
                        display: 82.15F
                      relativeHumidity:
                        value: 46.25
                        unit: "%"
                        display: 46.25%
                      windSpeed:
                        value: 7.5432
                        unit: mph
                        display: 7.5432mph
                      windDirection: 165.33
                      windGust:
                        value: 18.7218
                        unit: mph
                        display: 18.7218mph
                      windGustDirection: 165.33
                      wetBulb:
                        value: 67.124
                        unit: F
                        display: 67.124F
                      wetBulbGlobalTemp:
                        value: 73.612
                        unit: F
                        display: 73.612F
                      ambientHigh:
                        value: 84.7
                        unit: F
                        display: 84.7F
                      ambientLow:
                        value: 80.1
                        unit: F
                        display: 80.1F
                      heatIndex:
                        value: 82.4217
                        unit: F
                        display: 82.4217F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 27
                        unit: PM2.5
                        display: 27PM2.5
                      feelsLike:
                        value: 82.4217
                        unit: F
                        display: 82.4217F
                    - lastUpdated: 2026-04-01T01:00:00Z
                      ambientTemperature:
                        value: 79.12
                        unit: F
                        display: 79.12F
                      relativeHumidity:
                        value: 51.08
                        unit: "%"
                        display: 51.08%
                      windSpeed:
                        value: 3.1472
                        unit: mph
                        display: 3.1472mph
                      windDirection: 158.67
                      windGust:
                        value: 8.4125
                        unit: mph
                        display: 8.4125mph
                      windGustDirection: 158.67
                      wetBulb:
                        value: 65.923
                        unit: F
                        display: 65.923F
                      wetBulbGlobalTemp:
                        value: 71.218
                        unit: F
                        display: 71.218F
                      ambientHigh:
                        value: 80.9
                        unit: F
                        display: 80.9F
                      ambientLow:
                        value: 78.6
                        unit: F
                        display: 78.6F
                      heatIndex:
                        value: 79.1126
                        unit: F
                        display: 79.1126F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 33
                        unit: PM2.5
                        display: 33PM2.5
                      feelsLike:
                        value: 79.12
                        unit: F
                        display: 79.12F
                    - lastUpdated: 2026-04-01T02:00:00Z
                      ambientTemperature:
                        value: 77.83
                        unit: F
                        display: 77.83F
                      relativeHumidity:
                        value: 55.42
                        unit: "%"
                        display: 55.42%
                      windSpeed:
                        value: 4.8125
                        unit: mph
                        display: 4.8125mph
                      windDirection: 152.42
                      windGust:
                        value: 13.9213
                        unit: mph
                        display: 13.9213mph
                      windGustDirection: 152.42
                      wetBulb:
                        value: 66.423
                        unit: F
                        display: 66.423F
                      wetBulbGlobalTemp:
                        value: 71.512
                        unit: F
                        display: 71.512F
                      ambientHigh:
                        value: 79.2
                        unit: F
                        display: 79.2F
                      ambientLow:
                        value: 76.8
                        unit: F
                        display: 76.8F
                      heatIndex:
                        value: 77.8291
                        unit: F
                        display: 77.8291F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 36
                        unit: PM2.5
                        display: 36PM2.5
                      feelsLike:
                        value: 77.83
                        unit: F
                        display: 77.83F
                    - lastUpdated: 2026-04-01T03:00:00Z
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 34
                        unit: PM2.5
                        display: 34PM2.5
                daily:
                  summary: dataset=daily — DailyObservationModel entries (different shape)
                  value:
                    - lastUpdated: 2026-04-01T00:00:00Z
                      maxAmbientTemperature:
                        value: 84.6
                        unit: F
                        display: 84.6F
                      minAmbientTemperature:
                        value: 61.3
                        unit: F
                        display: 61.3F
                      avgAmbientTemperature:
                        value: 72.8
                        unit: F
                        display: 72.8F
                      relativeHumidity:
                        value: 58.12
                        unit: "%"
                        display: 58.12%
                      windSpeed:
                        value: 5.1728
                        unit: mph
                        display: 5.1728mph
                      windGust:
                        value: 14.6213
                        unit: mph
                        display: 14.6213mph
                      windDirection: 172.5
                      maxWetBulbGlobeTemp:
                        value: 76.9
                        unit: F
                        display: 76.9F
                      minWetBulbGlobeTemp:
                        value: 63.8
                        unit: F
                        display: 63.8F
                      heatIndex:
                        value: 82.4
                        unit: F
                        display: 82.4F
                      rainTotal:
                        value: 0.0134
                        unit: in
                        display: 0.0134in
                      aqiVal:
                        value: 31
                        unit: PM2.5
                        display: 31PM2.5
                    - lastUpdated: 2026-04-02T00:00:00Z
                      maxAmbientTemperature:
                        value: 81.9
                        unit: F
                        display: 81.9F
                      minAmbientTemperature:
                        value: 59.7
                        unit: F
                        display: 59.7F
                      avgAmbientTemperature:
                        value: 70.2
                        unit: F
                        display: 70.2F
                      relativeHumidity:
                        value: 62.41
                        unit: "%"
                        display: 62.41%
                      windSpeed:
                        value: 6.3921
                        unit: mph
                        display: 6.3921mph
                      windGust:
                        value: 17.1128
                        unit: mph
                        display: 17.1128mph
                      windDirection: 188.25
                      maxWetBulbGlobeTemp:
                        value: 74.3
                        unit: F
                        display: 74.3F
                      minWetBulbGlobeTemp:
                        value: 62.4
                        unit: F
                        display: 62.4F
                      heatIndex:
                        value: 79.8
                        unit: F
                        display: 79.8F
                      rainTotal:
                        value: 0.2451
                        unit: in
                        display: 0.2451in
                      aqiVal:
                        value: 28
                        unit: PM2.5
                        display: 28PM2.5
            text/json:
              schema:
                oneOf:
                  - title: ObservationModel[] — minutely / hourly
                    type: array
                    items:
                      $ref: "#/components/schemas/ObservationModel"
                  - title: DailyObservationModel[] — daily
                    type: array
                    items:
                      $ref: "#/components/schemas/DailyObservationModel"
              examples:
                minutely:
                  summary: dataset=minutely — 5-minute interval ObservationModel entries
                  value:
                    - lastUpdated: 2026-04-01T12:00:00Z
                      ambientTemperature:
                        value: 76.42
                        unit: F
                        display: 76.42F
                      relativeHumidity:
                        value: 57.33
                        unit: "%"
                        display: 57.33%
                      windSpeed:
                        value: 4.6312
                        unit: mph
                        display: 4.6312mph
                      windDirection: 182.5
                      windGust:
                        value: 11.0287
                        unit: mph
                        display: 11.0287mph
                      windGustDirection: 182.5
                      wetBulb:
                        value: 63.512
                        unit: F
                        display: 63.512F
                      wetBulbGlobalTemp:
                        value: 68.714
                        unit: F
                        display: 68.714F
                      ambientHigh:
                        value: 76.9
                        unit: F
                        display: 76.9F
                      ambientLow:
                        value: 76.1
                        unit: F
                        display: 76.1F
                      heatIndex:
                        value: 76.8534
                        unit: F
                        display: 76.8534F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0.0123
                        unit: in
                        display: 0.0123in
                      aqiVal:
                        value: 31
                        unit: PM2.5
                        display: 31PM2.5
                      feelsLike:
                        value: 76.42
                        unit: F
                        display: 76.42F
                    - lastUpdated: 2026-04-01T12:05:00Z
                      ambientTemperature:
                        value: 76.88
                        unit: F
                        display: 76.88F
                      relativeHumidity:
                        value: 56.91
                        unit: "%"
                        display: 56.91%
                      windSpeed:
                        value: 5.0129
                        unit: mph
                        display: 5.0129mph
                      windDirection: 186.25
                      windGust:
                        value: 11.6831
                        unit: mph
                        display: 11.6831mph
                      windGustDirection: 186.25
                      wetBulb:
                        value: 63.881
                        unit: F
                        display: 63.881F
                      wetBulbGlobalTemp:
                        value: 69.043
                        unit: F
                        display: 69.043F
                      ambientHigh:
                        value: 77.2
                        unit: F
                        display: 77.2F
                      ambientLow:
                        value: 76.4
                        unit: F
                        display: 76.4F
                      heatIndex:
                        value: 77.241
                        unit: F
                        display: 77.241F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0.0123
                        unit: in
                        display: 0.0123in
                      aqiVal:
                        value: 32
                        unit: PM2.5
                        display: 32PM2.5
                      feelsLike:
                        value: 76.88
                        unit: F
                        display: 76.88F
                hourly:
                  summary: dataset=hourly — hourly ObservationModel entries
                  value:
                    - lastUpdated: 2026-04-01T00:00:00Z
                      ambientTemperature:
                        value: 82.15
                        unit: F
                        display: 82.15F
                      relativeHumidity:
                        value: 46.25
                        unit: "%"
                        display: 46.25%
                      windSpeed:
                        value: 7.5432
                        unit: mph
                        display: 7.5432mph
                      windDirection: 165.33
                      windGust:
                        value: 18.7218
                        unit: mph
                        display: 18.7218mph
                      windGustDirection: 165.33
                      wetBulb:
                        value: 67.124
                        unit: F
                        display: 67.124F
                      wetBulbGlobalTemp:
                        value: 73.612
                        unit: F
                        display: 73.612F
                      ambientHigh:
                        value: 84.7
                        unit: F
                        display: 84.7F
                      ambientLow:
                        value: 80.1
                        unit: F
                        display: 80.1F
                      heatIndex:
                        value: 82.4217
                        unit: F
                        display: 82.4217F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 27
                        unit: PM2.5
                        display: 27PM2.5
                      feelsLike:
                        value: 82.4217
                        unit: F
                        display: 82.4217F
                    - lastUpdated: 2026-04-01T01:00:00Z
                      ambientTemperature:
                        value: 79.12
                        unit: F
                        display: 79.12F
                      relativeHumidity:
                        value: 51.08
                        unit: "%"
                        display: 51.08%
                      windSpeed:
                        value: 3.1472
                        unit: mph
                        display: 3.1472mph
                      windDirection: 158.67
                      windGust:
                        value: 8.4125
                        unit: mph
                        display: 8.4125mph
                      windGustDirection: 158.67
                      wetBulb:
                        value: 65.923
                        unit: F
                        display: 65.923F
                      wetBulbGlobalTemp:
                        value: 71.218
                        unit: F
                        display: 71.218F
                      ambientHigh:
                        value: 80.9
                        unit: F
                        display: 80.9F
                      ambientLow:
                        value: 78.6
                        unit: F
                        display: 78.6F
                      heatIndex:
                        value: 79.1126
                        unit: F
                        display: 79.1126F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 33
                        unit: PM2.5
                        display: 33PM2.5
                      feelsLike:
                        value: 79.12
                        unit: F
                        display: 79.12F
                    - lastUpdated: 2026-04-01T02:00:00Z
                      ambientTemperature:
                        value: 77.83
                        unit: F
                        display: 77.83F
                      relativeHumidity:
                        value: 55.42
                        unit: "%"
                        display: 55.42%
                      windSpeed:
                        value: 4.8125
                        unit: mph
                        display: 4.8125mph
                      windDirection: 152.42
                      windGust:
                        value: 13.9213
                        unit: mph
                        display: 13.9213mph
                      windGustDirection: 152.42
                      wetBulb:
                        value: 66.423
                        unit: F
                        display: 66.423F
                      wetBulbGlobalTemp:
                        value: 71.512
                        unit: F
                        display: 71.512F
                      ambientHigh:
                        value: 79.2
                        unit: F
                        display: 79.2F
                      ambientLow:
                        value: 76.8
                        unit: F
                        display: 76.8F
                      heatIndex:
                        value: 77.8291
                        unit: F
                        display: 77.8291F
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 36
                        unit: PM2.5
                        display: 36PM2.5
                      feelsLike:
                        value: 77.83
                        unit: F
                        display: 77.83F
                    - lastUpdated: 2026-04-01T03:00:00Z
                      rain1Hr:
                        value: 0
                        unit: in
                        display: 0in
                      rainToday:
                        value: 0
                        unit: in
                        display: 0in
                      aqiVal:
                        value: 34
                        unit: PM2.5
                        display: 34PM2.5
                daily:
                  summary: dataset=daily — DailyObservationModel entries (different shape)
                  value:
                    - lastUpdated: 2026-04-01T00:00:00Z
                      maxAmbientTemperature:
                        value: 84.6
                        unit: F
                        display: 84.6F
                      minAmbientTemperature:
                        value: 61.3
                        unit: F
                        display: 61.3F
                      avgAmbientTemperature:
                        value: 72.8
                        unit: F
                        display: 72.8F
                      relativeHumidity:
                        value: 58.12
                        unit: "%"
                        display: 58.12%
                      windSpeed:
                        value: 5.1728
                        unit: mph
                        display: 5.1728mph
                      windGust:
                        value: 14.6213
                        unit: mph
                        display: 14.6213mph
                      windDirection: 172.5
                      maxWetBulbGlobeTemp:
                        value: 76.9
                        unit: F
                        display: 76.9F
                      minWetBulbGlobeTemp:
                        value: 63.8
                        unit: F
                        display: 63.8F
                      heatIndex:
                        value: 82.4
                        unit: F
                        display: 82.4F
                      rainTotal:
                        value: 0.0134
                        unit: in
                        display: 0.0134in
                      aqiVal:
                        value: 31
                        unit: PM2.5
                        display: 31PM2.5
                    - lastUpdated: 2026-04-02T00:00:00Z
                      maxAmbientTemperature:
                        value: 81.9
                        unit: F
                        display: 81.9F
                      minAmbientTemperature:
                        value: 59.7
                        unit: F
                        display: 59.7F
                      avgAmbientTemperature:
                        value: 70.2
                        unit: F
                        display: 70.2F
                      relativeHumidity:
                        value: 62.41
                        unit: "%"
                        display: 62.41%
                      windSpeed:
                        value: 6.3921
                        unit: mph
                        display: 6.3921mph
                      windGust:
                        value: 17.1128
                        unit: mph
                        display: 17.1128mph
                      windDirection: 188.25
                      maxWetBulbGlobeTemp:
                        value: 74.3
                        unit: F
                        display: 74.3F
                      minWetBulbGlobeTemp:
                        value: 62.4
                        unit: F
                        display: 62.4F
                      heatIndex:
                        value: 79.8
                        unit: F
                        display: 79.8F
                      rainTotal:
                        value: 0.2451
                        unit: in
                        display: 0.2451in
                      aqiVal:
                        value: 28
                        unit: PM2.5
                        display: 28PM2.5
        "400":
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
            text/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
        "404":
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
            application/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
            text/json:
              schema:
                $ref: "#/components/schemas/ProblemDetails"
security:
  - ApiKeyAuth: []
components:
  schemas:
    ObservationModel:
      type: object
      properties:
        lastUpdated:
          type: string
          format: date-time
          nullable: true
        ambientTemperature:
          $ref: "#/components/schemas/ValueUnit"
        relativeHumidity:
          $ref: "#/components/schemas/ValueUnit"
        windSpeed:
          $ref: "#/components/schemas/ValueUnit"
        windDirection:
          type: number
          format: double
          nullable: true
        windGust:
          $ref: "#/components/schemas/ValueUnit"
        windGustDirection:
          type: number
          format: double
          nullable: true
        wetBulb:
          $ref: "#/components/schemas/ValueUnit"
        solarIrradiance:
          $ref: "#/components/schemas/ValueUnit"
        wetBulbGlobalTemp:
          $ref: "#/components/schemas/ValueUnit"
        windChill:
          $ref: "#/components/schemas/ValueUnit"
        ambientHigh:
          $ref: "#/components/schemas/ValueUnit"
        ambientLow:
          $ref: "#/components/schemas/ValueUnit"
        heatIndex:
          $ref: "#/components/schemas/ValueUnit"
        rain1Hr:
          $ref: "#/components/schemas/ValueUnit"
        rainToday:
          $ref: "#/components/schemas/ValueUnit"
        aqiVal:
          $ref: "#/components/schemas/ValueUnit"
        feelsLike:
          $ref: "#/components/schemas/ValueUnit"
      additionalProperties: false
    DailyObservationModel:
      type: object
      properties:
        lastUpdated:
          type: string
          format: date-time
          nullable: true
        maxAmbientTemperature:
          $ref: "#/components/schemas/ValueUnit"
        minAmbientTemperature:
          $ref: "#/components/schemas/ValueUnit"
        avgAmbientTemperature:
          $ref: "#/components/schemas/ValueUnit"
        relativeHumidity:
          $ref: "#/components/schemas/ValueUnit"
        windSpeed:
          $ref: "#/components/schemas/ValueUnit"
        windGust:
          $ref: "#/components/schemas/ValueUnit"
        windDirection:
          type: number
          format: double
          nullable: true
        maxWetBulbGlobeTemp:
          $ref: "#/components/schemas/ValueUnit"
        minWetBulbGlobeTemp:
          $ref: "#/components/schemas/ValueUnit"
        windChill:
          $ref: "#/components/schemas/ValueUnit"
        heatIndex:
          $ref: "#/components/schemas/ValueUnit"
        rainTotal:
          $ref: "#/components/schemas/ValueUnit"
        aqiVal:
          $ref: "#/components/schemas/ValueUnit"
      additionalProperties: false
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    ValueUnit:
      type: object
      properties:
        value:
          type: number
          format: double
        unit:
          type: string
          nullable: true
        display:
          type: string
          nullable: true
          readOnly: true
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: API key for authenticating requests. Create and manage keys in the
        Perry Weather dashboard under Integrations > Perry Weather APIs.
      name: x-api-key
      in: header
```