---
title: "Use to get climatology data such as past daily actual observed temperatures, precipitation, snowfall and snow depth."
method: GET
path: "/weather/historical/actuals/daily/{format}"
---

# Use to get climatology data such as past daily actual observed temperatures, precipitation, snowfall and snow depth.

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

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/weather/historical/actuals/daily/{format}`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
    - Scopes: `https://atlas.microsoft.com/.default`
  - API key in header `subscription-key`
  - API key in header `SAS Token`

The `Get Daily Historical Actuals` API is an HTTP `GET` request that returns
climatology data such as past daily actual observed temperatures,
precipitation, snowfall, snow depth and cooling/heating degree day information,
for the day at a given coordinate location. The data is requested for a
specified date range, up to 31 days in a single API request. 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.

- DailyHistoricalActualsResult: Returns an array of [DailyHistoricalActuals](#dailyhistoricalactuals) objects, each detailing the observed historical weather data for the specified date and location. The number of days included is determined by the `startDate` and `endDate` URI parameters which can include up to 31 days.
  - `results` DailyHistoricalActuals[]: Aggregates detailed historical weather data for specific dates and locations, including temperature, precipitation, snowfall, snow depth, and degree day summaries.
    - `date` string, date-time: The date and time for the requested weather data in ISO 8061 format 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).
    - `snowfall` 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).
    - `snowDepth` 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.

## Changes

- **2026-07-13** (1.0) `3c076fdd2918`: 1 info
  - endpoint added
- **2021-07-20** (1.0) `5ddaf6c2b291`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/azure/apis/maps-weather/changes/weather/historical/actuals/daily/:format/get.md)

---

[API](https://skmtc.dev/azure/apis/maps-weather.md) - [All operations](https://skmtc.dev/azure/apis/maps-weather/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/maps-weather/revisions/3c076fdd2918?raw)
