Current Weather Response Schema

Response body for the current weather endpoint

Example

{
  "location": {
    "lat": 40.7128,
    "lon": -74.006,
    "name": "New York",
    "admin": "New York",
    "country": "United States",
    "iso2": "US",
    "timezone": "America/New_York"
  },
  "data": {
    "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: `-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`

data

object

Describes the weather at a moment in time

Object Properties

Property Type Description Schema

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)

Example:65

Min: 0Max: 100

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)

Example:270

Min: 0Max: 360

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)

Example:35

Min: 0Max: 100

pop

number

Probability of precipitation (0-100)

Example:50

Min: 0Max: 100

precip_amount

number

Total precipitation amount. Millimeters for metric, inches for imperial

Example:0

precip_type

string

Type of precipitation

Example:rain

Allowed values:

none
rain
snow
rain_snow
ice_pellets
freezing_rain
mixed

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`

units

object

Unit labels for each measurement in the response.

Object Properties

Property	Type	Description
`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`