---
title: "Retrieve Historical Weather"
method: POST
path: "/historical"
---

# Retrieve Historical Weather

`POST /historical`

## Headers

- `Accept-Encoding` string, required

## Request body

- object
  - `location` string, json, required — ID of a pre-defined location, GeoJSON geometry or lat long array - see [formats](https://docs.tomorrow.io/reference/api-formats#locations)
  - `fields` string[], required — Selected fields from our data layers (polygon/polyline default to Max, if not suffix is not specified) - see [Historical Data Layers](https://docs.tomorrow.io/reference/historical)
  - `timesteps` string[], required — Timesteps of the historical: "1h" or "1d" (defaults to "1h"). "1d" timesteps will default select the Max value of the fields. Only 1 timestep can be requested in each API call
  - `startTime` string, required — Start time can be "nowMinus`X`m/h/d" or ISO 8601 format "2019-03-20T14:09:50Z".
  - `endTime` string, required — End time can be "nowMinus`X`m/h/d" or ISO 8601 format "2019-03-20T14:09:50Z".
  - `units` string — Unit system of the field values, either "metric" or "imperial" - see [Field Descriptors](https://docs.tomorrow.io/reference/weather-data-layers#field-descriptors)
  - `timezone` string — The timezone parameter displays the response datetime in the requested timezone. The timezone parameter is not affecting the request startTime and endTime. If you like to request data at a specific timezone, please add the timezone (in ISO 8601 format) to the startTime and endTime parameters. Timezone of time values, according to IANA Timezone Names (defaults to UTC) - see [Formats](https://docs.tomorrow.io/reference/api-formats#timezone)

## Response `200`

200

---

[API](https://skmtc.dev/tomorrow/apis/tomorrowio-api.md) · [All operations](https://skmtc.dev/tomorrow/apis/tomorrowio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tomorrow/tomorrowio-api/revisions/18905002092a/schema)