v1

latestOpenAPI 3.1.02026-07-24200331.1 KB

Retrieve Climate Normals

post/historical/normals

Headers

Accept-Encodingstring required

Request body

locationstring required

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

fieldsstring[] required

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

timestepsstring[] required

Currently support the "1d" time step.

startDatestring required

Climate normals only support "MM-DD" datetime format and is limited to 365 days. The climate normals aggregates data from 2000 to 2020.

endDatestring required

Climate normals only support "MM-DD" datetime format and is limited to 365 days. The climate normals aggregates data from 2000 to 2020.

unitsstring

Unit system of the field values, either "metric" or "imperial" - see Field Descriptors

Response

200

Example response

{
  "data": {
    "timelines": [
      {
        "timestep": "1d",
        "endTime": "01-02",
        "startTime": "01-01",
        "intervals": [
          {
            "startTime": "01-01",
            "values": {
              "precipitationAccumulationSum": 0.19,
              "precipitationAccumulationSumP50": 0.05,
              "precipitationAccumulationSumP95": 0.7,
              "temperatureAvg": 30.76,
              "temperatureAvgP5": 19.06,
              "temperatureAvgP50": 32.5,
              "temperatureAvgP95": 40.86,
              "temperatureMax": 37.18,
              "temperatureMaxP5": 25.37,
              "temperatureMaxP50": 36.57,
              "temperatureMaxP95": 49.75,
              "temperatureMin": 25.95,
              "temperatureMinP5": 12.46,
              "temperatureMinP50": 27.68,
              "temperatureMinP95": 37.07
            }
          }
        ]
      }
    ]
  }
}