---
title: "Retrieve Timelines"
method: POST
path: "/timelines"
---

# Retrieve Timelines

`POST /timelines`

## Headers

- `Accept-Encoding` string, required

## Request body

- object
  - `location` string, json — ID of a pre-defined location, GeoJSON geometry or latlong 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)
  - `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)
  - `timesteps` string[] — Timesteps of the timelines: "1m", "5m", "15m", "30m", "1h", "1d" or "current" (defaults to "1h") - see [Timestep Availability](https://docs.tomorrow.io/reference/weather-data-layers#timestep-availability)
  - `startTime` string — Start time can be "now", "nowPlus`X`m/h/d", "nowMinus`X`m/h/d" or ISO 8601 format "2019-03-20T14:09:50Z". (defaults to now)
  - `endTime` string — End time can be "now", "nowPlus`X`m/h/d", "nowMinus`X`m/h/d" or ISO 8601 format "2019-03-20T14:09:50Z". (defaults to now)
  - `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). Using the `auto` value will automatically set the timezone of the request location
  - `dailyStartHour` integer — This setting is used only with daily timesteps (1d) and determines when the daily aggregation period begins. By default, the aggregation runs from 6 AM to 6 AM. You can adjust this by setting dailyStartHour to any value between 0 and 23 (where 0 represents midnight, 1 represents 1 AM, and so on). For example, to aggregate from midnight to 11:59 PM, set dailyStartHour to 0.

## Response `200`

200

- object
  - `data` object
    - `timelines` object[]
      - `timestep` string
      - `endTime` string
      - `startTime` string
      - `intervals` object[]
        - `startTime` string
        - `values` object
          - `temperature` number

---

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