Weatherbit · Schema

CurrentObs

CurrentObs schema from Weatherbit API

WeatherForecastingHistorical DataAir QualityAlertsAgricultural Weather

Properties

Name Type Description
city_name string City name (closest)
state_code string State abbreviation
country_code string Country abbreviation
timezone string Local IANA time zone
lat number Latitude
lon number Longitude
station string Source Station ID
sources array List of data sources used in response
vis integer Visibility - default (M)
rh integer Relative humidity (%)
dewpt number Dew point temperature - default (C)
wind_dir integer Wind direction (degrees)
wind_cdir string Cardinal wind direction
wind_cdir_full string Cardinal wind direction (text)
wind_speed number Wind speed - Default (m/s)
temp number Temperature - Default (C)
app_temp number Apparent temperature - Default (C)
clouds integer Cloud cover (%)
weather object
datetime string Cycle Hour (UTC) of observation
ob_time string Full time (UTC) of observation (YYYY-MM-DD HH:MM)
ts number Unix Timestamp
sunrise string Time (UTC) of Sunrise (HH:MM)
sunset string Time (UTC) of Sunset (HH:MM)
slp number Mean sea level pressure in millibars (mb)
pres number Pressure (mb)
aqi number Air quality index (US EPA standard 0 to +500)
uv number UV Index
solar_rad number Estimated solar radiation (W/m^2)
ghi number Global horizontal irradiance (W/m^2)
dni number Direct normal irradiance (W/m^2)
dhi number Diffuse horizontal irradiance (W/m^2)
elev_angle number Current solar elevation angle (Degrees)
pod string Part of the day (d = day, n = night)
precip number Precipitation in last hour - Default (mm)
snow number Snowfall in last hour - Default (mm)
View JSON Schema on GitHub

JSON Schema

weatherbit-current-obs-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/weatherbit/refs/heads/main/json-schema/weatherbit-current-obs-schema.json",
  "title": "CurrentObs",
  "description": "CurrentObs schema from Weatherbit API",
  "type": "object",
  "properties": {
    "city_name": {
      "type": "string",
      "description": "City name (closest)",
      "example": "Raleigh"
    },
    "state_code": {
      "type": "string",
      "description": "State abbreviation",
      "example": "NC"
    },
    "country_code": {
      "type": "string",
      "description": "Country abbreviation",
      "example": "US"
    },
    "timezone": {
      "type": "string",
      "description": "Local IANA time zone",
      "example": "America/New_York"
    },
    "lat": {
      "type": "number",
      "description": "Latitude",
      "example": 38.0
    },
    "lon": {
      "type": "number",
      "description": "Longitude",
      "example": -78.25
    },
    "station": {
      "type": "string",
      "description": "Source Station ID",
      "example": "KRDU"
    },
    "sources": {
      "type": "array",
      "description": "List of data sources used in response",
      "items": {
        "type": "string",
        "example": "rtma"
      }
    },
    "vis": {
      "type": "integer",
      "description": "Visibility - default (M)",
      "example": 10000
    },
    "rh": {
      "type": "integer",
      "description": "Relative humidity (%)",
      "example": 75
    },
    "dewpt": {
      "type": "number",
      "description": "Dew point temperature - default (C)",
      "example": 12.0
    },
    "wind_dir": {
      "type": "integer",
      "description": "Wind direction (degrees)",
      "example": 125
    },
    "wind_cdir": {
      "type": "string",
      "description": "Cardinal wind direction",
      "example": "ENE"
    },
    "wind_cdir_full": {
      "type": "string",
      "description": "Cardinal wind direction (text)",
      "example": "East-North-East"
    },
    "wind_speed": {
      "type": "number",
      "description": "Wind speed - Default (m/s)",
      "example": 5.85
    },
    "temp": {
      "type": "number",
      "description": "Temperature - Default (C)",
      "example": 13.85
    },
    "app_temp": {
      "type": "number",
      "description": "Apparent temperature - Default (C)",
      "example": 14.85
    },
    "clouds": {
      "type": "integer",
      "description": "Cloud cover (%)",
      "example": 42
    },
    "weather": {
      "type": "object",
      "properties": {
        "icon": {
          "type": "string",
          "description": "Icon code for forecast image display",
          "example": "c02"
        },
        "code": {
          "type": "integer",
          "description": "Weather Condition code",
          "example": 802
        },
        "description": {
          "type": "string",
          "description": "Weather Condition description",
          "example": "Broken clouds"
        }
      }
    },
    "datetime": {
      "type": "string",
      "description": "Cycle Hour (UTC) of observation",
      "example": "2017-03-15:13"
    },
    "ob_time": {
      "type": "string",
      "description": "Full time (UTC) of observation (YYYY-MM-DD HH:MM)",
      "example": "2017-03-15 13:11"
    },
    "ts": {
      "type": "number",
      "description": "Unix Timestamp",
      "example": 1490990400
    },
    "sunrise": {
      "type": "string",
      "description": "Time (UTC) of Sunrise (HH:MM)",
      "example": "06:22"
    },
    "sunset": {
      "type": "string",
      "description": "Time (UTC) of Sunset (HH:MM)",
      "example": 1174
    },
    "slp": {
      "type": "number",
      "description": "Mean sea level pressure in millibars (mb)",
      "example": 1013.12
    },
    "pres": {
      "type": "number",
      "description": "Pressure (mb)",
      "example": 1010.0
    },
    "aqi": {
      "type": "number",
      "description": "Air quality index (US EPA standard 0 to +500)",
      "example": 50.0
    },
    "uv": {
      "type": "number",
      "description": "UV Index",
      "example": 6.5
    },
    "solar_rad": {
      "type": "number",
      "description": "Estimated solar radiation (W/m^2)",
      "example": 300.4
    },
    "ghi": {
      "type": "number",
      "description": "Global horizontal irradiance (W/m^2)",
      "example": 450.4
    },
    "dni": {
      "type": "number",
      "description": "Direct normal irradiance (W/m^2)",
      "example": 450.4
    },
    "dhi": {
      "type": "number",
      "description": "Diffuse horizontal irradiance (W/m^2)",
      "example": 450.4
    },
    "elev_angle": {
      "type": "number",
      "description": "Current solar elevation angle (Degrees)",
      "example": 37.0
    },
    "pod": {
      "type": "string",
      "description": "Part of the day (d = day, n = night)"
    },
    "precip": {
      "type": "number",
      "description": "Precipitation in last hour - Default (mm)",
      "example": 2.0
    },
    "snow": {
      "type": "number",
      "description": "Snowfall in last hour - Default (mm)",
      "example": 10.0
    }
  }
}