Forecast Response Schema

Response body for the forecast endpoint

Example

{
  "location": {
    "lat": 40.7128,
    "lon": -74.006,
    "name": "New York",
    "admin": "New York",
    "country": "United States",
    "iso2": "US",
    "timezone": "America/New_York"
  },
  "daily": [
    {
      "date": "2026-02-21",
      "temp_min": 18,
      "temp_max": 28.5,
      "temp_day": 25,
      "temp_night": 20,
      "feels_like_min": 15,
      "feels_like_max": 26,
      "feels_like_day": 23,
      "feels_like_night": 18,
      "precipitation": {
        "rain": 1.5,
        "snow": 1.5,
        "freezing_rain": 1.5,
        "sleet": 1.5,
        "ice_pellets": 1.5
      },
      "clouds_avg": 45,
      "pop": 60,
      "wind_speed_max": 15.3,
      "wind_gust_max": 22.1,
      "description": {
        "code": 520,
        "name": "Rain"
      }
    },
    ...
  ],
  "hourly": [
    {
      "time": "2026-02-20T12:00:00Z",
      "temp": 25.5,
      "feels_like": 22.3,
      "dew": 15.2,
      "humidity": 65,
      "wind_speed": 12.1,
      "wind_gust": 18.5,
      "wind_deg": 270,
      "wind_dir": "N",
      "pressure": 101.33,
      "vis": 24,
      "clouds": 35,
      "pop": 50,
      "precip_amount": 0,
      "precip_type": "rain",
      "description": {
        "code": 520,
        "name": "Rain"
      }
    },
    ...
  ],
  "units": {
    "temp": "°C",
    "feels_like": "°C",
    "dew": "°C",
    "wind_speed": "km/h",
    "wind_gust": "km/h",
    "pressure": "kPa",
    "vis": "km",
    "rain": "mm",
    "snow": "cm"
  }
}

Attributes

• location

  object

  Describes a point on Earth

  Object Properties

  Property	Type	Description	Schema
  lat	number	Latitude in decimal degrees Example:40.7128	Min: -90Max: 90
  lon	number	Longitude in decimal degrees Example:-74.006	Min: -180Max: 180
  name	string	City or locality name Example:New York
  admin	string	Administrative region (e.g. state or province) Example:New York
  country	string	Full country name Example:United States
  iso2	string	ISO 3166-1 alpha-2 country code Example:US
  timezone	string	IANA timezone identifier Example:America/New_York

• daily

  array

  Daily forecast records

  Array of: Daily Forecast

• hourly

  array

  Hourly forecast records. Omitted if hours was not requested

  Array of: Weather Data Object

• units

  object

  Unit labels for each measurement in the response.

  Object Properties

  Property	Type	Description	Schema
  temp	string	Unit label for all temperature values returned by the API Example:°C
  feels_like	string	Unit label for all apparent temperature values returned by the API Example:°C
  dew	string	Unit label for all dew point values returned by the API Example:°C
  wind_speed	string	Unit label for all wind speeds returned by the API Example:km/h
  wind_gust	string	Unit label for all wind gusts returned by the API Example:km/h
  pressure	string	Unit label for all atmospheric pressure values returned by the API Example:kPa
  vis	string	Unit label for all visibility distances returned by the API Example:km
  rain	string	Unit label for all rainfall amounts returned by the API Example:mm
  snow	string	Unit label for all snowfall amounts returned by the API Example:cm