---
title: "Retrieve Climate Normals"
method: POST
path: "/historical/normals"
---

# Retrieve Climate Normals

`POST /historical/normals`

## Headers

- `Accept-Encoding` string, required

## Request body

- object
  - `location` string, 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/update/reference/climate-normals)
  - `timesteps` string[], required — Currently support the "1d" time step.
  - `startDate` string, required — Climate normals only support "MM-DD" datetime format and is limited to 365 days. The climate normals aggregates data from 2000 to 2020.
  - `endDate` string, required — Climate normals only support "MM-DD" datetime format and is limited to 365 days. The climate normals aggregates data from 2000 to 2020.
  - `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)

## Response `200`

200

- object
  - `data` object
    - `timelines` object[]
      - `timestep` string
      - `endTime` string
      - `startTime` string
      - `intervals` object[]
        - `startTime` string
        - `values` object
          - `precipitationAccumulationSum` number
          - `precipitationAccumulationSumP5` integer
          - `precipitationAccumulationSumP50` number
          - `precipitationAccumulationSumP95` number
          - `temperatureAvg` number
          - `temperatureAvgP5` number
          - `temperatureAvgP50` number
          - `temperatureAvgP95` number
          - `temperatureMax` number
          - `temperatureMaxP5` number
          - `temperatureMaxP50` number
          - `temperatureMaxP95` number
          - `temperatureMin` number
          - `temperatureMinP5` number
          - `temperatureMinP50` number
          - `temperatureMinP95` number

## Other responses

- `400` — 400

---

[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)