Retrieve Historical Weather

post

https://api.tomorrow.io/v4/historical

Body Params

location

json

required

Defaults to 42.3478, -71.0466

ID of a pre-defined location, GeoJSON geometry or lat long array - see formats

fields

array of strings

required

Defaults to temperature

Selected fields from our data layers (polygon/polyline default to Max, if not suffix is not specified) - see Historical Data Layers

fields*

timesteps

array of strings

required

Defaults to 1h

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

timesteps*

startTime

string

required

Defaults to 2019-03-20T14:09:50Z

Start time can be "nowMinusXm/h/d" or ISO 8601 format "2019-03-20T14:09:50Z".

endTime

string

required

Defaults to 2019-03-28T14:09:50Z

End time can be "nowMinusXm/h/d" or ISO 8601 format "2019-03-20T14:09:50Z".

units

string

Defaults to metric

Unit system of the field values, either "metric" or "imperial" - see 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

Headers

Accept-Encoding

string

required

Defaults to gzip, deflate

Response

Language

Credentials

Query

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200