---
title: "Future Weather (14–300 days ahead)"
method: GET
path: "/future.json"
tags: ["Future"]
---

# Future Weather (14–300 days ahead)

`GET /future.json`

Returns 3-hourly weather forecast for a date between 14 days and 300 days in the future. Available on Pro+ plan and above.

## Query parameters

- `key` string, required
- `q` string, required
- `dt` string, date, required
- `lang` string

## Response `200`

Future weather data

- ForecastWeatherResponse
  - `location` Location — Location metadata returned with every weather response.
    - `name` string — Location name
    - `region` string — Region or state
    - `country` string — Country name
    - `lat` number, float — Latitude
    - `lon` number, float — Longitude
    - `tz_id` string — IANA timezone ID, e.g. Europe/London
    - `localtime_epoch` integer — Local time as Unix epoch
    - `localtime` string — Local date and time string
  - `current` CurrentWeather
    - `last_updated_epoch` integer
    - `last_updated` string
    - `temp_c` number — Temperature °C
    - `temp_f` number — Temperature °F
    - `is_day` integer — 1=day, 0=night
    - `condition` Condition
      - `text` string — Weather condition description
      - `icon` string — URL to condition icon
      - `code` integer — Condition code (see conditions.json)
    - `wind_mph` number
    - `wind_kph` number
    - `wind_degree` integer
    - `wind_dir` string — 16-point compass direction
    - `pressure_mb` number
    - `pressure_in` number
    - `precip_mm` number
    - `precip_in` number
    - `humidity` integer — Humidity %
    - `cloud` integer — Cloud cover %
    - `feelslike_c` number
    - `feelslike_f` number
    - `windchill_c` number
    - `windchill_f` number
    - `heatindex_c` number
    - `heatindex_f` number
    - `dewpoint_c` number
    - `dewpoint_f` number
    - `vis_km` number
    - `vis_miles` number
    - `uv` number — UV Index
    - `gust_mph` number
    - `gust_kph` number
    - `short_rad` number — GHI W/m² (paid plans)
    - `diff_rad` number — DHI W/m² (paid plans)
    - `air_quality` AirQuality — Air quality data. Returned when aqi=yes.
      - `co` number — Carbon monoxide µg/m³
      - `o3` number — Ozone µg/m³
      - `no2` number — Nitrogen dioxide µg/m³
      - `so2` number — Sulphur dioxide µg/m³
      - `pm2_5` number — PM2.5 µg/m³
      - `pm10` number — PM10 µg/m³
      - `us-epa-index` integer — US EPA index 1–6 (1=Good, 6=Hazardous)
      - `gb-defra-index` integer — UK DEFRA index 1–10
    - `pollen` Pollen — Pollen data in grains/m³. Returned when pollen=yes (Pro+ and above).
      - `Hazel` number
      - `Alder` number
      - `Birch` number
      - `Oak` number
      - `Grass` number
      - `Mugwort` number
      - `Ragweed` number
  - `forecast` object
    - `forecastday` ForecastDayEntry[]
      - `date` string, date
      - `date_epoch` integer
      - `day` ForecastDay
        - `maxtemp_c` number
        - `maxtemp_f` number
        - `mintemp_c` number
        - `mintemp_f` number
        - `avgtemp_c` number
        - `avgtemp_f` number
        - `maxwind_mph` number
        - `maxwind_kph` number
        - `totalprecip_mm` number
        - `totalprecip_in` number
        - `totalsnow_cm` number
        - `avgvis_km` number
        - `avgvis_miles` number
        - `avghumidity` integer
        - `daily_will_it_rain` integer
        - `daily_chance_of_rain` integer
        - `daily_will_it_snow` integer
        - `daily_chance_of_snow` integer
        - `condition` Condition
          - `text` string — Weather condition description
          - `icon` string — URL to condition icon
          - `code` integer — Condition code (see conditions.json)
        - `uv` number
        - `air_quality` AirQuality — Air quality data. Returned when aqi=yes.
          - `co` number — Carbon monoxide µg/m³
          - `o3` number — Ozone µg/m³
          - `no2` number — Nitrogen dioxide µg/m³
          - `so2` number — Sulphur dioxide µg/m³
          - `pm2_5` number — PM2.5 µg/m³
          - `pm10` number — PM10 µg/m³
          - `us-epa-index` integer — US EPA index 1–6 (1=Good, 6=Hazardous)
          - `gb-defra-index` integer — UK DEFRA index 1–10
      - `astro` AstroElement
        - `sunrise` string
        - `sunset` string
        - `moonrise` string
        - `moonset` string
        - `moon_phase` string
        - `moon_illumination` number
        - `is_moon_up` integer
        - `is_sun_up` integer
      - `hour` HourForecast[]
        - `time_epoch` integer
        - `time` string
        - `temp_c` number
        - `temp_f` number
        - `is_day` integer
        - `condition` Condition
          - `text` string — Weather condition description
          - `icon` string — URL to condition icon
          - `code` integer — Condition code (see conditions.json)
        - `wind_mph` number
        - `wind_kph` number
        - `wind_degree` integer
        - `wind_dir` string
        - `pressure_mb` number
        - `pressure_in` number
        - `precip_mm` number
        - `precip_in` number
        - `snow_cm` number
        - `humidity` integer
        - `cloud` integer
        - `feelslike_c` number
        - `feelslike_f` number
        - `windchill_c` number
        - `windchill_f` number
        - `heatindex_c` number
        - `heatindex_f` number
        - `dewpoint_c` number
        - `dewpoint_f` number
        - `will_it_rain` integer
        - `chance_of_rain` integer
        - `will_it_snow` integer
        - `chance_of_snow` integer
        - `vis_km` number
        - `vis_miles` number
        - `gust_mph` number
        - `gust_kph` number
        - `uv` number
        - `short_rad` number
        - `diff_rad` number
        - `et0` number — Evapotranspiration (Business+)
        - `air_quality` AirQuality — Air quality data. Returned when aqi=yes.
          - `co` number — Carbon monoxide µg/m³
          - `o3` number — Ozone µg/m³
          - `no2` number — Nitrogen dioxide µg/m³
          - `so2` number — Sulphur dioxide µg/m³
          - `pm2_5` number — PM2.5 µg/m³
          - `pm10` number — PM10 µg/m³
          - `us-epa-index` integer — US EPA index 1–6 (1=Good, 6=Hazardous)
          - `gb-defra-index` integer — UK DEFRA index 1–10
        - `pollen` Pollen — Pollen data in grains/m³. Returned when pollen=yes (Pro+ and above).
          - `Hazel` number
          - `Alder` number
          - `Birch` number
          - `Oak` number
          - `Grass` number
          - `Mugwort` number
          - `Ragweed` number
  - `alerts` object
    - `alert` Alert[]
      - `headline` string
      - `msgtype` string
      - `severity` string
      - `urgency` string
      - `areas` string
      - `category` string
      - `certainty` string
      - `event` string
      - `note` string
      - `effective` string
      - `expires` string
      - `desc` string
      - `instruction` string

## Other responses

- `400` — Bad request — invalid parameter or location not found.
- `401` — Unauthorized — API key missing or invalid.
- `403` — Forbidden — API key quota exceeded, disabled, or plan does not include this resource.

---

[API](https://skmtc.dev/weatherapi/apis/weatherapi-com.md) · [All operations](https://skmtc.dev/weatherapi/apis/weatherapi-com/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/weatherapi/weatherapi-com/revisions/bf3da15deb3e/schema)
