---
title: "Use to get climatology data such as past daily normal temperatures,
precipitation and cooling/heating degree day information for a given location."
method: GET
path: "/weather/historical/normals/daily/{format}"
---

# Use to get climatology data such as past daily normal temperatures,
precipitation and cooling/heating degree day information for a given location.

`GET /weather/historical/normals/daily/{format}`

The `Get Daily Historical Normals` API is an HTTP `GET` request that returns
climatology data such as past daily normal temperatures, precipitation and
cooling/heating degree day information for the day at a given coordinate
location. The historical normals are a 30-year average for temperatures and
precipitation for a specific location. As is standard practice in climatology,
the 30-year average covers years 1991-2020, this data will be used for one
decade and then will reset in the year 2030. Generally, historical data may be
available as far back as the last 5 to 40+ years, depending on the location.

## Path parameters

- `format` 'json', required

## Query parameters

- `api-version` string, required
- `query` number[], required
- `startDate` string, date, required
- `endDate` string, date, required
- `unit` 'imperial' | 'metric'

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- DailyHistoricalNormalsResult — Returns an array of [DailyHistoricalNormals](#dailyhistoricalnormals) objects, each detailing climatology data such as past daily normal temperatures, precipitation, and cooling/heating degree day information for the specified date range, calculated as a 30-year average (1991-2020). The number of days included is determined by the `startDate` and `endDate` URI parameters, which can include up to 31 days.
  - `results` DailyHistoricalNormals[] — Aggregates detailed climatology data for each requested day, including normal temperatures, precipitation, snowfall, snow depth, and degree day summaries.
    - `date` string, date-time — Date and time of the current observation, displayed in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*.
    - `temperature` WeatherValueMaxMinAvg — Returned temperature values.
      - `maximum` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
      - `minimum` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
      - `average` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `degreeDaySummary` DegreeDaySummary — Summary of heating and cooling degree days.
      - `heating` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
      - `cooling` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `precipitation` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
  - `nextLink` string — Contains the URL to fetch the next page of results if the response is paginated. This is useful when the response is too large to be returned in a single call, allowing users to navigate through multiple pages of results.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/revisions/3c076fdd2918/schema)