# Guide

The Historical API provides archived weather observation data going back to January 1, 1990, with support for JSON and CSV output.

For full request and response field details, see [Historical Parameters](/developers/historical/parameters).

:::note{title="Base URLs"}

- **Production:** api.accuweather.com
- **Development:** apidev.accuweather.com

Examples below use the production host. Swap in apidev.accuweather.com for development.

:::

| Endpoint | Description |
|---|---|
| [Daily historical search (meteorological day)](#daily-historical-search-meteorological-day) | Daily weather records for a specific date, covering the meteorological day (7 AM to 7 AM local time) |
| [Daily historical search (calendar day)](#daily-historical-search-calendar-day) | Daily weather records for a specific date, covering the calendar day (midnight to midnight local time) |

---

## Daily historical search (meteorological day)

By default, the Historical API returns data for the **meteorological day**: the 24-hour period from 7:00 AM local time on the requested date to 7:00 AM local time the following day. This convention aligns with standard meteorological observation practice.

```
https://{baseUrl}/historical/weather/{version}/daily/{locationKey}{.format}?apikey={your key}&date={date}&details={true or false}&metric={true or false}&language={language code}
```

---

## Daily historical search (calendar day)

Pass `calendar=true` to retrieve data for the **calendar day** instead: the 24-hour period from midnight to midnight local time on the requested date. Use this when aligning historical data with business or consumer day-based reporting.

```
https://{baseUrl}/historical/weather/{version}/daily/{locationKey}{.format}?apikey={your key}&date={date}&calendar=true&details={true or false}&metric={true or false}&language={language code}
```

**Example:**

```
https://api.accuweather.com/historical/weather/v1/daily/335315?apikey={your key}&date=2016-04-21&calendar=true
```

## Examples

### JSON format

```
https://api.accuweather.com/historical/weather/v1/daily/335315.json?apikey={your key}&date=2020-03-09&details=true
```

**Response:**

```json
[
    {
        "date": "2020-03-09T00:00:00-04:00",
        "epochDate": 1583726400,
        "temperature": {
            "minimum": {
                "value": 35.0,
                "unit": "F",
                "unitType": 18
            },
            "maximum": {
                "value": 63.0,
                "unit": "F",
                "unitType": 18
            },
            "average": {
                "value": 48.0,
                "unit": "F",
                "unitType": 18
            },
            "departure": {
                "value": 9.0,
                "unit": "F",
                "unitType": 18
            }
        },
        "dewPoint": {
            "minimum": {
                "value": 23.0,
                "unit": "F",
                "unitType": 18
            },
            "maximum": {
                "value": 41.0,
                "unit": "F",
                "unitType": 18
            },
            "average": {
                "value": 32.0,
                "unit": "F",
                "unitType": 18
            },
            "departure": {
                "value": 8.0,
                "unit": "F",
                "unitType": 18
            }
        },
        "relativeHumidity": {
            "minimum": 38.0,
            "maximum": 69.0,
            "average": 54.0,
            "departure": -1.0
        },
        "pressure": {
            "minimum": {
                "value": 28.78,
                "unit": "inHg",
                "unitType": 12
            },
            "maximum": {
                "value": 28.88,
                "unit": "inHg",
                "unitType": 12
            },
            "average": {
                "value": 28.83,
                "unit": "inHg",
                "unitType": 12
            },
            "departure": {
                "value": -0.09,
                "unit": "inHg",
                "unitType": 12
            }
        },
        "windSpeed": {
            "minimum": {
                "value": 4.6,
                "unit": "mi/h",
                "unitType": 9
            },
            "maximum": {
                "value": 7.9,
                "unit": "mi/h",
                "unitType": 9
            },
            "average": {
                "value": 5.9,
                "unit": "mi/h",
                "unitType": 9
            },
            "departure": {
                "value": 1.1,
                "unit": "mi/h",
                "unitType": 9
            }
        },
        "windGust": {
            "minimum": {
                "value": 13.8,
                "unit": "mi/h",
                "unitType": 9
            },
            "maximum": {
                "value": 25.6,
                "unit": "mi/h",
                "unitType": 9
            },
            "average": {
                "value": 18.4,
                "unit": "mi/h",
                "unitType": 9
            },
            "departure": {
                "value": 3.2,
                "unit": "mi/h",
                "unitType": 9
            }
        },
        "windDirection": {
            "degrees": 245,
            "localized": "WSW",
            "english": "WSW"
        },
        "dominantPrecipitationType": "No precipitation",
        "precipitation": {
            "value": 0.0,
            "unit": "in",
            "unitType": 1
        },
        "precipitationRate": {
            "minimum": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            },
            "maximum": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            },
            "average": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            }
        },
        "snowCover": {
            "minimum": 0.0,
            "maximum": 1.0,
            "average": 0.0,
            "departure": -1.0
        },
        "snowDepth": {
            "minimum": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            },
            "maximum": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            },
            "average": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            }
        },
        "snowLiquid": {
            "value": 0.0,
            "unit": "in",
            "unitType": 1
        },
        "snowLiquidRate": {
            "minimum": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            },
            "maximum": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            },
            "average": {
                "value": 0.0,
                "unit": "in",
                "unitType": 1
            }
        },
        "realFeel": {
            "minimum": {
                "value": 33.0,
                "unit": "F",
                "unitType": 18
            },
            "maximum": {
                "value": 67.0,
                "unit": "F",
                "unitType": 18
            },
            "average": {
                "value": 48.0,
                "unit": "F",
                "unitType": 18
            },
            "departure": {
                "value": 8.0,
                "unit": "F",
                "unitType": 18
            }
        },
        "realFeelShade": {
            "minimum": {
                "value": 35.0,
                "unit": "F",
                "unitType": 18
            },
            "maximum": {
                "value": 63.0,
                "unit": "F",
                "unitType": 18
            },
            "average": {
                "value": 48.0,
                "unit": "F",
                "unitType": 18
            },
            "departure": {
                "value": 9.0,
                "unit": "F",
                "unitType": 18
            }
        },
        "heatIndex": null,
        "windChill": {
            "minimum": {
                "value": 17.0,
                "unit": "F",
                "unitType": 18
            },
            "maximum": {
                "value": 24.0,
                "unit": "F",
                "unitType": 18
            },
            "average": {
                "value": 20.0,
                "unit": "F",
                "unitType": 18
            },
            "departure": {
                "value": 2.0,
                "unit": "F",
                "unitType": 18
            }
        },
        "wetBulb": {
            "minimum": {
                "value": 30.0,
                "unit": "F",
                "unitType": 18
            },
            "maximum": {
                "value": 50.0,
                "unit": "F",
                "unitType": 18
            },
            "average": {
                "value": 40.0,
                "unit": "F",
                "unitType": 18
            },
            "departure": {
                "value": 8.0,
                "unit": "F",
                "unitType": 18
            }
        },
        "soilTemperature": {
            "minimum": {
                "value": 34.0,
                "unit": "F",
                "unitType": 18
            },
            "maximum": {
                "value": 52.0,
                "unit": "F",
                "unitType": 18
            },
            "average": {
                "value": 39.0,
                "unit": "F",
                "unitType": 18
            },
            "departure": {
                "value": 2.0,
                "unit": "F",
                "unitType": 18
            }
        },
        "soilMoisture": {
            "minimum": {
                "value": 0.0,
                "unit": "ft\u00b3/ft\u00b3",
                "unitType": 36
            },
            "maximum": {
                "value": 0.0,
                "unit": "ft\u00b3/ft\u00b3",
                "unitType": 36
            },
            "average": {
                "value": 0.0,
                "unit": "ft\u00b3/ft\u00b3",
                "unitType": 36
            }
        },
        "meanSeaLevelPressure": {
            "minimum": {
                "value": 30.21,
                "unit": "inHg",
                "unitType": 12
            },
            "maximum": {
                "value": 30.38,
                "unit": "inHg",
                "unitType": 12
            },
            "average": {
                "value": 30.3,
                "unit": "inHg",
                "unitType": 12
            },
            "departure": {
                "value": -0.13,
                "unit": "inHg",
                "unitType": 12
            }
        },
        "cloudBase": {
            "minimum": {
                "value": 18600.0,
                "unit": "ft",
                "unitType": 0
            },
            "maximum": {
                "value": 32000.0,
                "unit": "ft",
                "unitType": 0
            },
            "average": {
                "value": 23400.0,
                "unit": "ft",
                "unitType": 0
            },
            "departure": {
                "value": -800.0,
                "unit": "ft",
                "unitType": 0
            }
        },
        "cloudCover": {
            "minimum": 0.0,
            "maximum": 100.0,
            "average": 53.0,
            "departure": 35.0
        },
        "uvIndex": {
            "minimum": 0.0,
            "maximum": 4.3,
            "average": 1.1,
            "departure": -0.1
        },
        "solarIrradiance": {
            "maximum": {
                "value": 238.44,
                "unit": "BTU/hr/ft\u00b2",
                "unitType": 34
            },
            "average": {
                "value": 68.44,
                "unit": "BTU/hr/ft\u00b2",
                "unitType": 34
            },
            "total": {
                "value": 1642.46,
                "unit": "BTU/hr/ft\u00b2",
                "unitType": 34
            }
        },
        "solarRadiation": {
            "maximum": {
                "value": 203.91,
                "unit": "BTU/hr/ft\u00b2",
                "unitType": 34
            },
            "average": {
                "value": 58.52,
                "unit": "BTU/hr/ft\u00b2",
                "unitType": 34
            },
            "total": {
                "value": 1404.46,
                "unit": "BTU/hr/ft\u00b2",
                "unitType": 34
            }
        },
        "evapotranspiration": {
            "value": 0.1,
            "unit": "in",
            "unitType": 1
        },
        "minutesOfSun": 400,
        "minutesOfPrecipitation": 60,
        "minutesOfSnow": 0,
        "degreeDaysSummary": {
            "cooling": {
                "value": 0.0,
                "unit": "F",
                "unitType": 18
            },
            "effective": {
                "value": 18.0,
                "unit": "F",
                "unitType": 18
            },
            "freezing": {
                "value": 0.0,
                "unit": "F",
                "unitType": 18
            },
            "growing": {
                "value": 0.0,
                "unit": "F",
                "unitType": 18
            },
            "heating": {
                "value": 17.0,
                "unit": "F",
                "unitType": 18
            }
        }
    }
]
```

### CSV format

```
https://api.accuweather.com/historical/weather/v1/daily/335315.csv?apikey={your key}&date=2020-03-09&details=true
```

**Response:**

```
"date","epochdate","temperature_min","temperature_max","temperature_avg","temperature_dep","realfeel_min","realfeel_max","realfeel_avg","realfeel_dep","realfeelshade_min","realfeelshade_max","realfeelshade_avg","realfeelshade_dep","heatindex_min","heatindex_max","heatindex_avg","heatindex_dep","dewpoint_min","dewpoint_max","dewpoint_avg","dewpoint_dep","windchill_min","windchill_max","windchill_avg","windchill_dep","wetbulb_min","wetbulb_max","wetbulb_avg","wetbulb_dep","soiltemperature_min","soiltemperature_max","soiltemperature_avg","soiltemperature_dep","soilmoisture_min","soilmoisture_max","soilmoisture_avg","relativehumidity_min","relativehumidity_max","relativehumidity_avg","relativehumidity_dep","pressure_min","pressure_max","pressure_avg","pressure_dep","meansealevelpressure_min","meansealevelpressure_max","meansealevelpressure_avg","meansealevelpressure_dep","windspeed_min","windspeed_max","windspeed_avg","windspeed_dep","windgust_min","windgust_max","windgust_avg","windgust_dep","winddirection_degrees","winddirection_localized","winddirection_english","cloudbase_min","cloudbase_max","cloudbase_avg","cloudbase_dep","cloudcover_min","cloudcover_max","cloudcover_avg","cloudcover_dep","uvindex_min","uvindex_max","uvindex_avg","uvindex_dep","precipitation","dominantprecipitationtype","precipitationrate_min","precipitationrate_max","precipitationrate_avg","snowcover_min","snowcover_max","snowcover_avg","snowcover_dep","snowdepth_min","snowdepth_max","snowdepth_avg","snowliquid","snowliquidrate_min","snowliquidrate_max","snowliquidrate_avg","solarirradiance_max","solarirradiance_avg","solarirradiance_total","solarradiation_max","solarradiation_avg","solarradiation_total","evapotranspiration","minutesofsun","minutesofprecipitation","minutesofsnow","degreedays_cooling","degreedays_effective","degreedays_freezing","degreedays_growing","degreedays_heating"
"3/9/2020 12:00:00 AM -04:00","1583726400","35.16","62.89","47.93","8.7","33.12","67.36","48.26","8.16","33.12","63.78","46.81","8.49","","","","","22.58","40.55","32.16","7.84","16.89","24.06","19.79","2","29.86","49.85","39.96","7.64","33.72","52.4","39.18","2.28","0.35","0.4","0.38","38","69","54","-1","28.78","28.88","28.83","-0.09","30.21","30.38","30.3","-0.13","4.6","7.9","5.9","1.1","13.8","25.6","18.4","3.2","245.3000030517578","WSW","WSW","18600","32000","23400","-800","0","100","53","35","0","4.3","1.1","-0.1","0","No precipitation","0","0","0","0","1","0","-1","0","0","0","0","0","0","0","238.44","68.44","1642.46","203.91","58.52","1404.46","0.105","400","60","0","0","18","0","0","17"
```