WeatherAPI · Schema

ForecastDayEntry

ForecastDayEntry schema from WeatherAPI.com

WeatherForecastHistoryMarineAstronomyGeolocationSportsAlertsPublic APIs

Properties

Name Type Description
date string
date_epoch integer
day object
astro object
hour array
View JSON Schema on GitHub

JSON Schema

weatherapi-forecast-day-entry-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/weatherapi/refs/heads/main/json-schema/weatherapi-forecast-day-entry-schema.json",
  "title": "ForecastDayEntry",
  "description": "ForecastDayEntry schema from WeatherAPI.com",
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-05-28"
    },
    "date_epoch": {
      "type": "integer",
      "example": 1748441400
    },
    "day": {
      "type": "object",
      "properties": {
        "maxtemp_c": {
          "type": "number",
          "example": 18.5
        },
        "maxtemp_f": {
          "type": "number",
          "example": 65.3
        },
        "mintemp_c": {
          "type": "number",
          "example": 18.5
        },
        "mintemp_f": {
          "type": "number",
          "example": 65.3
        },
        "avgtemp_c": {
          "type": "number",
          "example": 18.5
        },
        "avgtemp_f": {
          "type": "number",
          "example": 65.3
        },
        "maxwind_mph": {
          "type": "number",
          "example": 12.4
        },
        "maxwind_kph": {
          "type": "number",
          "example": 12.4
        },
        "totalprecip_mm": {
          "type": "number",
          "example": 0.5
        },
        "totalprecip_in": {
          "type": "number",
          "example": 0.5
        },
        "totalsnow_cm": {
          "type": "number",
          "example": 1.0
        },
        "avgvis_km": {
          "type": "number",
          "example": 10.0
        },
        "avgvis_miles": {
          "type": "number",
          "example": 10.0
        },
        "avghumidity": {
          "type": "integer",
          "example": 65
        },
        "daily_will_it_rain": {
          "type": "integer",
          "example": 1
        },
        "daily_chance_of_rain": {
          "type": "integer",
          "example": 1
        },
        "daily_will_it_snow": {
          "type": "integer",
          "example": 1
        },
        "daily_chance_of_snow": {
          "type": "integer",
          "example": 1
        },
        "condition": {
          "type": "object",
          "properties": {
            "text": {
              "type": "string",
              "description": "Weather condition description",
              "example": "Partly Cloudy"
            },
            "icon": {
              "type": "string",
              "description": "URL to condition icon",
              "example": "//cdn.weatherapi.com/weather/64x64/day/116.png"
            },
            "code": {
              "type": "integer",
              "description": "Condition code (see conditions.json)",
              "example": 1003
            }
          }
        },
        "uv": {
          "type": "number",
          "example": 4.0
        },
        "air_quality": {
          "type": "object",
          "description": "Air quality data. Returned when aqi=yes.",
          "properties": {
            "co": {
              "type": "number",
              "description": "Carbon monoxide µg/m³",
              "example": 1.0
            },
            "o3": {
              "type": "number",
              "description": "Ozone µg/m³",
              "example": 1.0
            },
            "no2": {
              "type": "number",
              "description": "Nitrogen dioxide µg/m³",
              "example": 1.0
            },
            "so2": {
              "type": "number",
              "description": "Sulphur dioxide µg/m³",
              "example": 1.0
            },
            "pm2_5": {
              "type": "number",
              "description": "PM2.5 µg/m³",
              "example": 1.0
            },
            "pm10": {
              "type": "number",
              "description": "PM10 µg/m³",
              "example": 1.0
            },
            "us-epa-index": {
              "type": "integer",
              "description": "US EPA index 1–6 (1=Good, 6=Hazardous)",
              "example": 1
            },
            "gb-defra-index": {
              "type": "integer",
              "description": "UK DEFRA index 1–10",
              "example": 1
            }
          }
        }
      }
    },
    "astro": {
      "type": "object",
      "properties": {
        "sunrise": {
          "type": "string",
          "example": "05:30 AM"
        },
        "sunset": {
          "type": "string",
          "example": "08:45 PM"
        },
        "moonrise": {
          "type": "string",
          "example": "10:15 PM"
        },
        "moonset": {
          "type": "string",
          "example": "06:42 AM"
        },
        "moon_phase": {
          "type": "string",
          "example": "Waxing Crescent"
        },
        "moon_illumination": {
          "type": "number",
          "example": 35.0
        },
        "is_moon_up": {
          "type": "integer",
          "example": 1
        },
        "is_sun_up": {
          "type": "integer",
          "example": 1
        }
      }
    },
    "hour": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "time_epoch": {
            "type": "integer",
            "example": 1748441400
          },
          "time": {
            "type": "string",
            "example": "sample value"
          },
          "temp_c": {
            "type": "number",
            "example": 18.5
          },
          "temp_f": {
            "type": "number",
            "example": 65.3
          },
          "is_day": {
            "type": "integer",
            "example": 1
          },
          "condition": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "description": "Weather condition description",
                "example": "Partly Cloudy"
              },
              "icon": {
                "type": "string",
                "description": "URL to condition icon",
                "example": "//cdn.weatherapi.com/weather/64x64/day/116.png"
              },
              "code": {
                "type": "integer",
                "description": "Condition code (see conditions.json)",
                "example": 1003
              }
            }
          },
          "wind_mph": {
            "type": "number",
            "example": 12.4
          },
          "wind_kph": {
            "type": "number",
            "example": 12.4
          },
          "wind_degree": {
            "type": "integer",
            "example": 1
          },
          "wind_dir": {
            "type": "string",
            "example": "WSW"
          },
          "pressure_mb": {
            "type": "number",
            "example": 1013.0
          },
          "pressure_in": {
            "type": "number",
            "example": 1013.0
          },
          "precip_mm": {
            "type": "number",
            "example": 0.5
          },
          "precip_in": {
            "type": "number",
            "example": 0.5
          },
          "snow_cm": {
            "type": "number",
            "example": 1.0
          },
          "humidity": {
            "type": "integer",
            "example": 65
          },
          "cloud": {
            "type": "integer",
            "example": 40
          },
          "feelslike_c": {
            "type": "number",
            "example": 17.8
          },
          "feelslike_f": {
            "type": "number",
            "example": 17.8
          },
          "windchill_c": {
            "type": "number",
            "example": 12.4
          },
          "windchill_f": {
            "type": "number",
            "example": 12.4
          },
          "heatindex_c": {
            "type": "number",
            "example": 1.0
          },
          "heatindex_f": {
            "type": "number",
            "example": 1.0
          },
          "dewpoint_c": {
            "type": "number",
            "example": 1.0
          },
          "dewpoint_f": {
            "type": "number",
            "example": 1.0
          },
          "will_it_rain": {
            "type": "integer",
            "example": 1
          },
          "chance_of_rain": {
            "type": "integer",
            "example": 1
          },
          "will_it_snow": {
            "type": "integer",
            "example": 1
          },
          "chance_of_snow": {
            "type": "integer",
            "example": 1
          },
          "vis_km": {
            "type": "number",
            "example": 10.0
          },
          "vis_miles": {
            "type": "number",
            "example": 10.0
          },
          "gust_mph": {
            "type": "number",
            "example": 22.1
          },
          "gust_kph": {
            "type": "number",
            "example": 22.1
          },
          "uv": {
            "type": "number",
            "example": 4.0
          },
          "short_rad": {
            "type": "number",
            "example": 1.0
          },
          "diff_rad": {
            "type": "number",
            "example": 1.0
          },
          "et0": {
            "type": "number",
            "description": "Evapotranspiration (Business+)",
            "example": 1.0
          },
          "air_quality": {
            "type": "object",
            "description": "Air quality data. Returned when aqi=yes.",
            "properties": {
              "co": {
                "type": "number",
                "description": "Carbon monoxide µg/m³",
                "example": 1.0
              },
              "o3": {
                "type": "number",
                "description": "Ozone µg/m³",
                "example": 1.0
              },
              "no2": {
                "type": "number",
                "description": "Nitrogen dioxide µg/m³",
                "example": 1.0
              },
              "so2": {
                "type": "number",
                "description": "Sulphur dioxide µg/m³",
                "example": 1.0
              },
              "pm2_5": {
                "type": "number",
                "description": "PM2.5 µg/m³",
                "example": 1.0
              },
              "pm10": {
                "type": "number",
                "description": "PM10 µg/m³",
                "example": 1.0
              },
              "us-epa-index": {
                "type": "integer",
                "description": "US EPA index 1–6 (1=Good, 6=Hazardous)",
                "example": 1
              },
              "gb-defra-index": {
                "type": "integer",
                "description": "UK DEFRA index 1–10",
                "example": 1
              }
            }
          },
          "pollen": {
            "type": "object",
            "description": "Pollen data in grains/m³. Returned when pollen=yes (Pro+ and above).",
            "properties": {
              "Hazel": {
                "type": "number",
                "example": 1.0
              },
              "Alder": {
                "type": "number",
                "example": 1.0
              },
              "Birch": {
                "type": "number",
                "example": 1.0
              },
              "Oak": {
                "type": "number",
                "example": 1.0
              },
              "Grass": {
                "type": "number",
                "example": 1.0
              },
              "Mugwort": {
                "type": "number",
                "example": 1.0
              },
              "Ragweed": {
                "type": "number",
                "example": 1.0
              }
            }
          }
        }
      }
    }
  }
}