Weather Data Object Schema

Describes the weather at a moment in time

Example

{
  "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"
  }
}

Attributes

• time

  string

  Observation time in ISO 8601 format (UTC)

  Example:2026-02-20T12:00:00Z

• temp

  number

  Air temperature. Units will be Celsius for metric or Fahrenheit for imperial

  Example:25.5

• feels_like

  number

  Apparent temperature. Units will be Celsius for metric or Fahrenheit for imperial

  Example:22.3

• dew

  number

  Dew point temperature. Units will be Celsius for metric or Fahrenheit for imperial

  Example:15.2

• humidity

  integer

  Relative humidity percentage (0-100)

  Min: 0Max: 100

  Example:65

• wind_speed

  number

  Wind speed. Units are km/h for metric or mph for imperial

  Example:12.1

• wind_gust

  number

  Wind gust speed. Units are km/h for metric or mph for imperial

  Example:18.5

• wind_deg

  number

  Wind direction in degrees (0-360)

  Min: 0Max: 360

  Example:270

• wind_dir

  string

  Cardinal wind direction

  Example:NESW

• pressure

  number

  Atmospheric pressure. kPa for metric, inHg for imperial

  Example:101.33

• vis

  number

  Visibility. Kilometers for metric, miles for imperial

  Example:24

• clouds

  integer

  Cloud coverage percentage (0-100)

  Min: 0Max: 100

  Example:35

• pop

  number

  Probability of precipitation (0-100)

  Min: 0Max: 100

  Example:50

• precip_amount

  number

  Total precipitation amount. Millimeters for metric, inches for imperial

  Example:0

• precip_type

  string

  Type of precipitation

  Allowed values:

  • none
  • rain
  • snow
  • rain_snow
  • ice_pellets
  • freezing_rain
  • mixed

  Example:rain

• description

  object

  Provides a human and machine readable description of the weather

  Object Properties

  Property	Type	Description	Schema
  code	integer	Numeric weather condition code Example:520	Allowed values: 100 - Clear 200 - Mostly sunny 210 - Partly cloudy 220 - Mostly cloudy 230 - Cloudy 300 - Fog 301 - Mist 310 - Smoke 400 - Chance of thunderstorms 410 - Thunderstorm 420 - Heavy thunderstorm 500 - Drizzle 510 - Light rain 520 - Rain 530 - Heavy rain 590 - Mixed (daily only) 600 - Freezing rain 610 - Sleet 620 - Ice pellets 700 - Light snow 710 - Snow 720 - Heavy snow 730 - Blowing snow 740 - Blizzard
  name	string	Human-readable weather condition name Example:Rain