<!-- block-id: concept -->

## History API for Timestamp

### Product concept

This product provides historical weather data for any timestamp from 1st January 1979 till now. Data are available for any coordinate on the globe.

Specify any coordinates and points in time up to 47+ years back, and get historical weather data by all necessary weather [parameters](#fields).

<!-- block-id: city -->

## How to request historical data

Call historical data by geographic coordinates.

### API call

```text
https://history.openweathermap.org/data/3.0/history/timemachine?lat={lat}&lon={lon}&dt={dt}&appid={API key}
```

| Parameters |  |  |
| --- | --- | --- |
| `lat` | Yes | Latitude. If you need a geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our [Geocoding API](/api/geocoding-api.md). |
| `lon` | Yes | Longitude. If you need a geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our [Geocoding API](/api/geocoding-api.md). |
| `dt` | Yes | Timestamp (unix time, UTC time zone), e.g. dt=1369728000 Data available from 1st January 1979 till now |
| `appid` | Yes | Your unique API key (you can always find it on your account page under the ["API key" tab](https://home.openweathermap.org/api_keys)) |

### Example of API call

```text
https://history.openweathermap.org/data/3.0/history/timemachine?lat=51.51&lon=-0.13&dt=606348800&appid={API key}
```

<!-- block-id: response -->

## History API response

> If you do not see some of the parameters in your API response it means that these weather phenomena are just not happened for the time of measurement for the city or location chosen. Only really measured or calculated data is displayed in API response.

### Example of API response

```json
{
  "coord": {
    "lon": -0.13,
    "lat": 51.51
  },
  "sys": {
    "type": 1,
    "id": 300001635,
    "message": 0
  },
  "weather": [
    {
      "id": 300,
      "main": "Drizzle",
      "description": "light intensity drizzle",
      "icon": "09n"
    }
  ],
  "base": "stations",
  "visibility": 10000,
  "main": {
    "temp": 282.91,
    "feels_like": 277.13,
    "pressure": 1007,
    "humidity": 82,
    "temp_min": 281.648,
    "temp_max": 283.55
  },
  "wind": {
    "speed": 7.2,
    "deg": 190
  },
  "clouds": {
    "all": 90
  },
  "rain": {
    "1h": 0.28
  },
  "dt": 606348800
}
```

<!-- block-id: fields -->

### Fields in API response

- `coord` Internal parameter
- `sys`  - `type` Internal field
  - `id` Internal field
  - `message` Internal field
- `weather` ([Full list of weather conditions](/weather-conditions.md#Weather-Condition-Codes-2))  - `weather.id` Weather condition id
  - `weather.main` Group of weather parameters (Rain, Snow, Clouds etc.)
  - `weather.description` Weather condition within the group
  - `weather.icon` Weather icon id
- `base` Internal field
- `visibility`  (where available) Average visibility, metres. The maximum value of the visibility is 10km
- `main`  - `main.temp` Temperature, Kelvins
  - `main.feels_like` Temperature, Kelvins. This temperature parameter accounts for the human perception of weather
  - `main.pressure` Atmospheric pressure on the sea level, hPa
  - `main.humidity` Humidity, %
  - `main.temp_min` Minimum temperature within a large city or a megalopolis (optional parameter), Kelvin
  - `main.temp_max` Maximum temperature within a large city or a megalopolis (optional parameter), Kelvins
- `wind`  - `wind.speed` Wind speed. Unit: meter/sec.
  - `wind.deg` Wind direction, degrees (meteorological)
- `clouds`  - `clouds.all` Cloudiness, %
- `rain`  - `rain.1h` Rain volume for the last 1 hour
- `snow`  - `snow.1h` Snow volume for the last 1 hour
- `dt` Time of data calculation, unix, UTC

<!-- block-id: promotion -->

> We provide a broad variety of products such as [One Call API 4.0,](/api/one-call-4.md)  [Solar Irradiance & Energy Prediction service,](/api.md#solar)  [Road Risk API,](/api/road-risk.md)  [Air Pollution API](/api/air-pollution.md) and solutions for advanced weather parameters like solar irradiance data, UVI, dew point, government weather alerts, etc. Please review our [product list](/api.md) page and find more info in the product documentation and [pricing](/price.md) pages.

<!-- block-id: list -->

### List of weather condition codes

List of [weather condition codes](/weather-conditions.md) with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere etc.)