---
title: "Get Hourly Forecast"
method: GET
path: "/forecast/hourly"
tags: ["weather > forecast"]
---

# Get Hourly Forecast

`GET /forecast/hourly`

Get hourly weather forecast for a specific location

## Query parameters

- `latitude` number, double, required
- `longitude` number, double, required
- `timezone` 'local' | 'utc'
- `units` 'metric' | 'imperial'
- `include_past` boolean

## Headers

- `X-API-KEY` string, required

## Response `200`

Successful Response

- TypeHourlyWeatherResponse
  - `latitude` number, double, required
  - `longitude` number, double, required
  - `forecast_time` string, date-time, required
  - `timezone` string, required
  - `utc_offset` integer, required
  - `elevation` integer
  - `units` union, required
    - TypeMetricUnits
      - `elevation` string
      - `temperature` string
      - `feels_like_temperature` string
      - `precipitation_accumulation` string
      - `precipitation_probability` string
      - `snowfall_accumulation` string
      - `cloud_cover` string
      - `humidity` string
      - `wind_speed` string
      - `wind_direction` string
      - `dewpoint_temperature` string
      - `pressure` string
      - `downward_solar_radiation` string
      - `wind_speed_100m` string
      - `wind_direction_100m` string
      - `global_horizontal_irradiation` string
      - `direct_normal_irradiation` string
      - `diffuse_horizontal_irradiation` string
    - TypeImperialUnits
      - `elevation` string
      - `temperature` string
      - `feels_like_temperature` string
      - `precipitation_accumulation` string
      - `precipitation_probability` string
      - `snowfall_accumulation` string
      - `cloud_cover` string
      - `humidity` string
      - `wind_speed` string
      - `wind_direction` string
      - `dewpoint_temperature` string
      - `pressure` string
      - `downward_solar_radiation` string
      - `wind_speed_100m` string
      - `wind_direction_100m` string
      - `global_horizontal_irradiation` string
      - `direct_normal_irradiation` string
      - `diffuse_horizontal_irradiation` string
  - `hourly` TypeHourlyConditions[], required
    - `timestamp` string, date-time, required
    - `temperature` number, double
    - `precipitation_accumulation` number, double
    - `precipitation_probability` integer
    - `precipitation_type` 'liquid' | 'snow' | 'hail' | 'sleet' | 'freezing_rain'
    - `snowfall_accumulation` number, double
    - `cloud_cover` integer
    - `humidity` integer
    - `wind_speed` number, double
    - `wind_direction` number, double
    - `dewpoint_temperature` number, double
    - `pressure` number, double
    - `downward_solar_radiation` number, double
    - `wind_speed_100m` number, double
    - `wind_direction_100m` number, double
    - `feels_like_temperature` number, double
    - `weather_code` 'clear-night' | 'clear-day' | 'partly-cloudy-day' | 'partly-cloudy-night' | 'cloudy' | 'rain' | 'snow'
    - `global_horizontal_irradiation` number, double
    - `direct_normal_irradiation` number, double
    - `diffuse_horizontal_irradiation` number, double

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/silurian/apis/api-reference.md) · [All operations](https://skmtc.dev/silurian/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/silurian/api-reference/revisions/0a7fc1c9fab7/schema)