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,
      "feels_like_min": 15,
      "feels_like_max": 26,
      "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"
      },
      "sunrise": 1112356800,
      "sunset": 1112400000
    },
    ...
  ],
  "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": "celsius",
    "feels_like": "celsius",
    "dew": "celsius",
    "wind_speed": "kilometers_per_hour",
    "wind_gust": "kilometers_per_hour",
    "pressure": "kilopascals",
    "vis": "kilometers",
    "rain": "millimeters",
    "snow": "centimeters"
  }
}

Attributes

location

object

Describes a point on Earth

Object Properties

Property	Type	Description	Schema
`lat`	number	Latitude in decimal degrees Example:`40.7128`	Min: `-90`Max: `90`
`lon`	number	Longitude in decimal degrees Example:`-74.006`	Min: `-180`Max: `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 types for each measurement in the response.

Object Properties

Property	Type	Description	Schema
`temp`	string	Unit type for all temperature values returned by the API Example:`celsius`	Allowed values: `celsius` `fahrenheit`
`feels_like`	string	Unit type for all apparent temperature values returned by the API Example:`celsius`	Allowed values: `celsius` `fahrenheit`
`dew`	string	Unit type for all dew point values returned by the API Example:`celsius`	Allowed values: `celsius` `fahrenheit`
`wind_speed`	string	Unit type for all wind speeds returned by the API Example:`kilometers_per_hour`	Allowed values: `kilometers_per_hour` `miles_per_hour`
`wind_gust`	string	Unit type for all wind gusts returned by the API Example:`kilometers_per_hour`	Allowed values: `kilometers_per_hour` `miles_per_hour`
`pressure`	string	Unit type for all atmospheric pressure values returned by the API Example:`kilopascals`	Allowed values: `kilopascals` `inches_of_mercury`
`vis`	string	Unit type for all visibility distances returned by the API Example:`kilometers`	Allowed values: `kilometers` `miles`
`rain`	string	Unit type for all rainfall amounts returned by the API Example:`millimeters`	Allowed values: `millimeters` `inches`
`snow`	string	Unit type for all snowfall amounts returned by the API Example:`centimeters`	Allowed values: `centimeters` `inches`