Get Forecasts

The forecasts endpoint or data set provides the core forecast data for US and international locations. Forecast information is available in daily, day/night intervals, as well as, custom intervals such as 3 hour or 1 hour intervals.

URL

https://{{HOST}}/weather/aerisweather/forecasts/{id}?filter={filter}&limit={number}

Method

GET

Required IMS Scopes

  • weatherapi_all

URL Path Parameters

Name Description Example Type
id
required		 The ID can be a zip code, place name, comma-separated pair of coordinates, and so on. /forecasts/53202 string

URL Query Parameters

Name Description Example Type
filter
optional		 Filtering the data you get back /forecasts/53202?filter=day [day, daynight, #hr]
limit
optional		 Limit the amount of data you get back /forecasts/53202?limit=5 number

Request Header Parameters

Type Value Description
Authorization Bearer {access_token}
required		 IMS access token

Example

Request

curl -X GET 
  'https://{{HOST}}/weather/aerisweather/forecasts/53202' 
  -H 'Authorization: Bearer {{access_token}}'

Response

{
    "loc": {
        "long": -93.264,
        "lat": 44.98
    },
    "interval": "day",
    "periods": [{
        "timestamp": 1318417200,
        "validTime": "2011-10-12T06:00:00-05:00",
        "dateTimeISO": "2011-10-12T06:00:00-05:00",
        "maxTempC": 21,
        "maxTempF": 70,
        "minTempC": 11,
        "minTempF": 52,
        "avgTempC": 18,
        "avgTempF": 64,
        "tempC": null,
        "tempF": null,
        "pop": 30,
        "precipMM": 4.06,
        "precipIN": 0.16,
        "iceaccum": 0,
        "maxHumidity": 80,
        "minHumidity": 62,
        "humidity": 71,
        "uvi": 9,
        "pressureMB": 1025,
        "pressureIN": 30.27,
        "sky": 75,
        "snowCM": 0,
        "snowIN": 0,
        "feelslikeC": 15,
        "feelslikeF": 59,
        "minFeelslikeC": 15,
        "minFeelslikeF": 59,
        "maxFeelslikeC": 20,
        "maxFeelslikeF": 68,
        "avgFeelslikeC": 17,
        "avgFeelslikeF": 63,
        "dewpointC": 12,
        "dewpointF": 54,
        "maxDewpointC": 14,
        "maxDewpointF": 58,
        "minDewpointC": 12,
        "minDewpointF": 54,
        "avgDewpointC": 13,
        "avgDewpointF": 56,
        "windDirDEG": 210,
        "windDir": "SSW",
        "windDirMaxDEG": 140,
        "windDirMax": "SE",
        "windDirMinDEG": 140,
        "windDirMin": "SE",
        "windGustKTS": 6,
        "windGustKPH": 11,
        "windGustMPH": 7,
        "windSpeedKTS": 6,
        "windSpeedKPH": 11,
        "windSpeedMPH": 7,
        "windSpeedMaxKTS": 6,
        "windSpeedMaxKPH": 11,
        "windSpeedMaxMPH": 7,
        "windSpeedMinKTS": 4,
        "windSpeedMinKPH": 8,
        "windSpeedMinMPH": 5,
        "windDir80mDEG": 0,
        "windDir80m": "ESE",
        "windDirMax80mDEG": 140,
        "windDirMax80m": "SE",
        "windDirMin80mDEG": 120,
        "windDirMin80m": "ESE",
        "windGust80mKTS": 14,
        "windGust80mKPH": 25,
        "windGst80mMPH": 16,
        "windSpeed80mKTS": 13,
        "windSpeed80mKPH": 24,
        "windSpeed80mMPH": 15,
        "windSpeedMax80mKTS": 14,
        "windSpeedMax80mKPH": 25,
        "windSpeedMax80mMPH": 16,
        "windSpeedMin80mKTS": 12,
        "windSpeedMin80mKPH": 21,
        "windSpeedMin80mMPH": 13,
        "sunriseISO": "2015-06-01T05:29:15-05:00",
        "sunsetISO": "2015-06-01T20:52:40-05:00",
        "weather": "Mostly Cloudy with Isolated Storms",
        "weatherCoded": [{
          "timestamp": 1318417200,
          "wx": "L:L:RW,IS::T"
        },
        {
          "timestamp": 1318456800,
          "wx": "CHC:L:RW"
        }],
        "weatherPrimary": "Isolated Storms",
        "weatherPrimaryCoded": "IS::T",
        "cloudsCoded": "BK",
        "icon": "mcloudyt.png",
        "isDay": true,
        "sunrise": 1318422338,
        "sunset": 1318462389
    }],
    "profile": {
            "tz": "America/Chicago"
    }
}