Location Key

1 hour by location key

GET

https://dataservice.accuweather.com

/forecasts/v1/hourly/1hour/{locationKey}

Returns forecast data for the next hour for a specific location, using a locationKey obtained from another endpoint (e.g., city search or geoposition)

1 hour by location key › path Parameters

locationKey

string · required

A unique ID that designates a specific location. More information can be found here.

Example: 349727

1 hour by location key › query Parameters

format

string

A string value that specifies what type of format to provide the response.

Default: json

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

metric

boolean

A boolean value that specifies whether to return the data in metric units (true) or imperial units (false). More information can be found here.

Default: false

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

1 hour by location key › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

1 hour by location key › Responses

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast[]

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast

DateTime

string · date-time · required

Datetime of the forecast displayed in ISO8601 format: (yyyy-mm-ddThh:mm:ss±hh:mm).

EpochDateTime

integer · int64 · required

Datetime of the forecast displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

WeatherIcon

integer · int32 · required

Numeric value representing an image that displays the IconPhrase.

IconPhrase

string · minLength: 1 · required

Phrase description of the forecast. Displayed in specified language.

HasPrecipitation

boolean · required

Boolean value that indicates the presence of any type of precipitation. Displays true if precipitation is present.

IsDaylight

boolean · required

Boolean value (true or false) that specifies whether or not it is daylight.

required

An object containing the forecasted temperature with a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

AccuLumenBrightnessIndex

number · float · required

An index value that indicates how bright the sunlight will be. Values are returned as a decimal from 0 to 10.00.

MobileLink

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's mobile site for the requested location.

Link

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's free site for the requested location.

PrecipitationType

string | null

Indicates if the precipitation is rain, snow, ice, or mixed. Only returned if HasPrecipitation is true.

PrecipitationIntensity

string | null

Indicates if the precipitation strength is light, moderate, or heavy. Only returned if HasPrecipitation is true.

An object containing the patented AccuWeather RealFeel™ temperature with a rounded value in the specified units, Fahrenheit or Celsius. The object also contains a brief description of how warm or cold the temperature actually feels outside. The object may be NULL.

An object containing the patented AccuWeather RealFeel™ shade temperature with a rounded value in the specified units, Fahrenheit or Celsius. The object also contains a brief description of how warm or cold the temperature actually feels outside. The object may be NULL.

The temperature to which air may be cooled by evaporating water into it at constant pressure until it reaches saturation. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

A temperature value that indicates heat stress on the human body in direct sunlight based on temperature, humidity, wind speed, sun angle, and cloud cover. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

The temperature at which the humidity in the air will begin to condense on surfaces. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

An object containing wind direction and speed information with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

An object containing information about the maximum short-burst wind speed with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

RelativeHumidity

integer | null · int32

A measure of water vapor in the air, expressed as a percentage of the amount needed for saturation.

IndoorRelativeHumidity

integer | null · int32

A measure of moisture in the air inside a typical heated home, expressed as a percentage of the maximum amount possible at the same temperature. At temperatures above 68°F this is set to the outdoor relative humidity.

An object containing information about visibility distance with a rounded value in the specified units, Miles or Kilometer. The object may be NULL.

An object containing information about the cloud base elevation with a rounded value in the specified units, Feet or Meter. The object may be NULL.

UVIndex

integer · int32

A numerical value that indicates the sun's measured ultraviolet radiation strength.

UVIndexFloat

number · float

A decimal value that indicates the sun's measured ultraviolet radiation strength.

UVIndexText

string | null

Text associated with the UVIndex.

ThunderstormProbability

integer | null · int32

A percentage value representing the probability of a thunderstorm.

RainProbability

integer | null · int32

A percentage value representing the probability of rain.

SnowProbability

integer · int64

A percentage value representing the probability of snow.

IceProbability

integer | null · int32

A percentage value representing the probability of ice.

A measurement of total liquid for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of rain for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of snow for the hour. An object with a rounded value in the specified units, Inch or Centimeter. The object may be NULL.

A measurement of ice for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

CloudCover

integer | null · int32

The percentage of cloud cover.

Soil water loss by evaporation and plant transpiration. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

The sun's electromagnetic radiation (global horizontal irradiance) as measured at the Earth's surface. An object with a rounded value in Watts per square Meter. The object may be NULL.

The temperature combined with wind speed to express how it will feel. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

Perceived outdoor temperature from combined air temperature and humidity. Valid in hot conditions (≥80 °F), computed via the NWS Rothfusz 9-term equation. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

GET/forecasts/v1/hourly/1hour/{locationKey}

curl https://dataservice.accuweather.com/forecasts/v1/hourly/1hour/:locationKey \
  --header 'Authorization: <api-key>'

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": "PrecipitationType",
    "PrecipitationIntensity": "PrecipitationIntensity",
    "IsDaylight": true,
    "Temperature": {},
    "RealFeelTemperature": {},
    "RealFeelTemperatureShade": {},
    "WetBulbTemperature": {},
    "WetBulbGlobeTemperature": {},
    "DewPoint": {},
    "Wind": {},
    "WindGust": {},
    "RelativeHumidity": 0,
    "IndoorRelativeHumidity": 0,
    "Visibility": {},
    "Ceiling": {},
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": "UVIndexText",
    "PrecipitationProbability": 0,
    "ThunderstormProbability": 0,
    "RainProbability": 0,
    "SnowProbability": 0,
    "IceProbability": 0,
    "TotalLiquid": {},
    "Rain": {},
    "Snow": {},
    "Ice": {},
    "CloudCover": 0,
    "Evapotranspiration": {},
    "SolarIrradiance": {},
    "AccuLumenBrightnessIndex": 0,
    "WindChillTemperature": {},
    "HeatIndex": {},
    "MobileLink": "MobileLink",
    "Link": "Link"
  }
]

json

application/json

12 hours by location key

GET

https://dataservice.accuweather.com

/forecasts/v1/hourly/12hour/{locationKey}

Returns forecast data for the next 12 hours for a specific location, using a locationKey obtained from another endpoint (e.g., city search or geoposition)

12 hours by location key › path Parameters

locationKey

string · required

A unique ID that designates a specific location. More information can be found here.

Example: 349727

12 hours by location key › query Parameters

format

string

A string value that specifies what type of format to provide the response.

Default: json

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

metric

boolean

A boolean value that specifies whether to return the data in metric units (true) or imperial units (false). More information can be found here.

Default: false

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

12 hours by location key › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

12 hours by location key › Responses

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast[]

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast

DateTime

string · date-time · required

Datetime of the forecast displayed in ISO8601 format: (yyyy-mm-ddThh:mm:ss±hh:mm).

EpochDateTime

integer · int64 · required

Datetime of the forecast displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

WeatherIcon

integer · int32 · required

Numeric value representing an image that displays the IconPhrase.

IconPhrase

string · minLength: 1 · required

Phrase description of the forecast. Displayed in specified language.

HasPrecipitation

boolean · required

Boolean value that indicates the presence of any type of precipitation. Displays true if precipitation is present.

IsDaylight

boolean · required

Boolean value (true or false) that specifies whether or not it is daylight.

required

An object containing the forecasted temperature with a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

AccuLumenBrightnessIndex

number · float · required

An index value that indicates how bright the sunlight will be. Values are returned as a decimal from 0 to 10.00.

MobileLink

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's mobile site for the requested location.

Link

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's free site for the requested location.

PrecipitationType

string | null

Indicates if the precipitation is rain, snow, ice, or mixed. Only returned if HasPrecipitation is true.

PrecipitationIntensity

string | null

Indicates if the precipitation strength is light, moderate, or heavy. Only returned if HasPrecipitation is true.

The temperature at which the humidity in the air will begin to condense on surfaces. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

An object containing wind direction and speed information with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

An object containing information about the maximum short-burst wind speed with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

RelativeHumidity

integer | null · int32

A measure of water vapor in the air, expressed as a percentage of the amount needed for saturation.

IndoorRelativeHumidity

integer | null · int32

An object containing information about visibility distance with a rounded value in the specified units, Miles or Kilometer. The object may be NULL.

An object containing information about the cloud base elevation with a rounded value in the specified units, Feet or Meter. The object may be NULL.

UVIndex

integer · int32

A numerical value that indicates the sun's measured ultraviolet radiation strength.

UVIndexFloat

number · float

A decimal value that indicates the sun's measured ultraviolet radiation strength.

UVIndexText

string | null

Text associated with the UVIndex.

ThunderstormProbability

integer | null · int32

A percentage value representing the probability of a thunderstorm.

RainProbability

integer | null · int32

A percentage value representing the probability of rain.

SnowProbability

integer · int64

A percentage value representing the probability of snow.

IceProbability

integer | null · int32

A percentage value representing the probability of ice.

A measurement of total liquid for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of rain for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of snow for the hour. An object with a rounded value in the specified units, Inch or Centimeter. The object may be NULL.

A measurement of ice for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

CloudCover

integer | null · int32

The percentage of cloud cover.

Soil water loss by evaporation and plant transpiration. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

The sun's electromagnetic radiation (global horizontal irradiance) as measured at the Earth's surface. An object with a rounded value in Watts per square Meter. The object may be NULL.

The temperature combined with wind speed to express how it will feel. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

GET/forecasts/v1/hourly/12hour/{locationKey}

curl https://dataservice.accuweather.com/forecasts/v1/hourly/12hour/:locationKey \
  --header 'Authorization: <api-key>'

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": "PrecipitationType",
    "PrecipitationIntensity": "PrecipitationIntensity",
    "IsDaylight": true,
    "Temperature": {},
    "RealFeelTemperature": {},
    "RealFeelTemperatureShade": {},
    "WetBulbTemperature": {},
    "WetBulbGlobeTemperature": {},
    "DewPoint": {},
    "Wind": {},
    "WindGust": {},
    "RelativeHumidity": 0,
    "IndoorRelativeHumidity": 0,
    "Visibility": {},
    "Ceiling": {},
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": "UVIndexText",
    "PrecipitationProbability": 0,
    "ThunderstormProbability": 0,
    "RainProbability": 0,
    "SnowProbability": 0,
    "IceProbability": 0,
    "TotalLiquid": {},
    "Rain": {},
    "Snow": {},
    "Ice": {},
    "CloudCover": 0,
    "Evapotranspiration": {},
    "SolarIrradiance": {},
    "AccuLumenBrightnessIndex": 0,
    "WindChillTemperature": {},
    "HeatIndex": {},
    "MobileLink": "MobileLink",
    "Link": "Link"
  }
]

json

application/json

24 hours by location key

GET

https://dataservice.accuweather.com

/forecasts/v1/hourly/24hour/{locationKey}

Returns forecast data for the next 24 hours for a specific location, using a locationKey obtained from another endpoint (e.g., city search or geoposition)

24 hours by location key › path Parameters

locationKey

string · required

A unique ID that designates a specific location. More information can be found here.

Example: 349727

24 hours by location key › query Parameters

format

string

A string value that specifies what type of format to provide the response.

Default: json

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

metric

boolean

A boolean value that specifies whether to return the data in metric units (true) or imperial units (false). More information can be found here.

Default: false

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

24 hours by location key › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

24 hours by location key › Responses

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast[]

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast

DateTime

string · date-time · required

Datetime of the forecast displayed in ISO8601 format: (yyyy-mm-ddThh:mm:ss±hh:mm).

EpochDateTime

integer · int64 · required

Datetime of the forecast displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

WeatherIcon

integer · int32 · required

Numeric value representing an image that displays the IconPhrase.

IconPhrase

string · minLength: 1 · required

Phrase description of the forecast. Displayed in specified language.

HasPrecipitation

boolean · required

Boolean value that indicates the presence of any type of precipitation. Displays true if precipitation is present.

IsDaylight

boolean · required

Boolean value (true or false) that specifies whether or not it is daylight.

required

An object containing the forecasted temperature with a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

AccuLumenBrightnessIndex

number · float · required

An index value that indicates how bright the sunlight will be. Values are returned as a decimal from 0 to 10.00.

MobileLink

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's mobile site for the requested location.

Link

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's free site for the requested location.

PrecipitationType

string | null

Indicates if the precipitation is rain, snow, ice, or mixed. Only returned if HasPrecipitation is true.

PrecipitationIntensity

string | null

Indicates if the precipitation strength is light, moderate, or heavy. Only returned if HasPrecipitation is true.

The temperature at which the humidity in the air will begin to condense on surfaces. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

An object containing wind direction and speed information with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

An object containing information about the maximum short-burst wind speed with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

RelativeHumidity

integer | null · int32

A measure of water vapor in the air, expressed as a percentage of the amount needed for saturation.

IndoorRelativeHumidity

integer | null · int32

An object containing information about visibility distance with a rounded value in the specified units, Miles or Kilometer. The object may be NULL.

An object containing information about the cloud base elevation with a rounded value in the specified units, Feet or Meter. The object may be NULL.

UVIndex

integer · int32

A numerical value that indicates the sun's measured ultraviolet radiation strength.

UVIndexFloat

number · float

A decimal value that indicates the sun's measured ultraviolet radiation strength.

UVIndexText

string | null

Text associated with the UVIndex.

ThunderstormProbability

integer | null · int32

A percentage value representing the probability of a thunderstorm.

RainProbability

integer | null · int32

A percentage value representing the probability of rain.

SnowProbability

integer · int64

A percentage value representing the probability of snow.

IceProbability

integer | null · int32

A percentage value representing the probability of ice.

A measurement of total liquid for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of rain for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of snow for the hour. An object with a rounded value in the specified units, Inch or Centimeter. The object may be NULL.

A measurement of ice for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

CloudCover

integer | null · int32

The percentage of cloud cover.

Soil water loss by evaporation and plant transpiration. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

The sun's electromagnetic radiation (global horizontal irradiance) as measured at the Earth's surface. An object with a rounded value in Watts per square Meter. The object may be NULL.

The temperature combined with wind speed to express how it will feel. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

GET/forecasts/v1/hourly/24hour/{locationKey}

curl https://dataservice.accuweather.com/forecasts/v1/hourly/24hour/:locationKey \
  --header 'Authorization: <api-key>'

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": "PrecipitationType",
    "PrecipitationIntensity": "PrecipitationIntensity",
    "IsDaylight": true,
    "Temperature": {},
    "RealFeelTemperature": {},
    "RealFeelTemperatureShade": {},
    "WetBulbTemperature": {},
    "WetBulbGlobeTemperature": {},
    "DewPoint": {},
    "Wind": {},
    "WindGust": {},
    "RelativeHumidity": 0,
    "IndoorRelativeHumidity": 0,
    "Visibility": {},
    "Ceiling": {},
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": "UVIndexText",
    "PrecipitationProbability": 0,
    "ThunderstormProbability": 0,
    "RainProbability": 0,
    "SnowProbability": 0,
    "IceProbability": 0,
    "TotalLiquid": {},
    "Rain": {},
    "Snow": {},
    "Ice": {},
    "CloudCover": 0,
    "Evapotranspiration": {},
    "SolarIrradiance": {},
    "AccuLumenBrightnessIndex": 0,
    "WindChillTemperature": {},
    "HeatIndex": {},
    "MobileLink": "MobileLink",
    "Link": "Link"
  }
]

json

application/json

72 hours by location key

GET

https://dataservice.accuweather.com

/forecasts/v1/hourly/72hour/{locationKey}

Returns forecast data for the next 72 hours for a specific location, using a locationKey obtained from another endpoint (e.g., city search or geoposition)

72 hours by location key › path Parameters

locationKey

string · required

A unique ID that designates a specific location. More information can be found here.

Example: 349727

72 hours by location key › query Parameters

format

string

A string value that specifies what type of format to provide the response.

Default: json

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

metric

boolean

A boolean value that specifies whether to return the data in metric units (true) or imperial units (false). More information can be found here.

Default: false

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

72 hours by location key › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

72 hours by location key › Responses

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast[]

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast

DateTime

string · date-time · required

Datetime of the forecast displayed in ISO8601 format: (yyyy-mm-ddThh:mm:ss±hh:mm).

EpochDateTime

integer · int64 · required

Datetime of the forecast displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

WeatherIcon

integer · int32 · required

Numeric value representing an image that displays the IconPhrase.

IconPhrase

string · minLength: 1 · required

Phrase description of the forecast. Displayed in specified language.

HasPrecipitation

boolean · required

Boolean value that indicates the presence of any type of precipitation. Displays true if precipitation is present.

IsDaylight

boolean · required

Boolean value (true or false) that specifies whether or not it is daylight.

required

An object containing the forecasted temperature with a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

AccuLumenBrightnessIndex

number · float · required

An index value that indicates how bright the sunlight will be. Values are returned as a decimal from 0 to 10.00.

MobileLink

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's mobile site for the requested location.

Link

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's free site for the requested location.

PrecipitationType

string | null

Indicates if the precipitation is rain, snow, ice, or mixed. Only returned if HasPrecipitation is true.

PrecipitationIntensity

string | null

Indicates if the precipitation strength is light, moderate, or heavy. Only returned if HasPrecipitation is true.

The temperature at which the humidity in the air will begin to condense on surfaces. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

An object containing wind direction and speed information with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

An object containing information about the maximum short-burst wind speed with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

RelativeHumidity

integer | null · int32

A measure of water vapor in the air, expressed as a percentage of the amount needed for saturation.

IndoorRelativeHumidity

integer | null · int32

An object containing information about visibility distance with a rounded value in the specified units, Miles or Kilometer. The object may be NULL.

An object containing information about the cloud base elevation with a rounded value in the specified units, Feet or Meter. The object may be NULL.

UVIndex

integer · int32

A numerical value that indicates the sun's measured ultraviolet radiation strength.

UVIndexFloat

number · float

A decimal value that indicates the sun's measured ultraviolet radiation strength.

UVIndexText

string | null

Text associated with the UVIndex.

ThunderstormProbability

integer | null · int32

A percentage value representing the probability of a thunderstorm.

RainProbability

integer | null · int32

A percentage value representing the probability of rain.

SnowProbability

integer · int64

A percentage value representing the probability of snow.

IceProbability

integer | null · int32

A percentage value representing the probability of ice.

A measurement of total liquid for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of rain for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of snow for the hour. An object with a rounded value in the specified units, Inch or Centimeter. The object may be NULL.

A measurement of ice for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

CloudCover

integer | null · int32

The percentage of cloud cover.

Soil water loss by evaporation and plant transpiration. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

The sun's electromagnetic radiation (global horizontal irradiance) as measured at the Earth's surface. An object with a rounded value in Watts per square Meter. The object may be NULL.

The temperature combined with wind speed to express how it will feel. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

GET/forecasts/v1/hourly/72hour/{locationKey}

curl https://dataservice.accuweather.com/forecasts/v1/hourly/72hour/:locationKey \
  --header 'Authorization: <api-key>'

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": "PrecipitationType",
    "PrecipitationIntensity": "PrecipitationIntensity",
    "IsDaylight": true,
    "Temperature": {},
    "RealFeelTemperature": {},
    "RealFeelTemperatureShade": {},
    "WetBulbTemperature": {},
    "WetBulbGlobeTemperature": {},
    "DewPoint": {},
    "Wind": {},
    "WindGust": {},
    "RelativeHumidity": 0,
    "IndoorRelativeHumidity": 0,
    "Visibility": {},
    "Ceiling": {},
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": "UVIndexText",
    "PrecipitationProbability": 0,
    "ThunderstormProbability": 0,
    "RainProbability": 0,
    "SnowProbability": 0,
    "IceProbability": 0,
    "TotalLiquid": {},
    "Rain": {},
    "Snow": {},
    "Ice": {},
    "CloudCover": 0,
    "Evapotranspiration": {},
    "SolarIrradiance": {},
    "AccuLumenBrightnessIndex": 0,
    "WindChillTemperature": {},
    "HeatIndex": {},
    "MobileLink": "MobileLink",
    "Link": "Link"
  }
]

json

application/json

120 hours by location key

GET

https://dataservice.accuweather.com

/forecasts/v1/hourly/120hour/{locationKey}

Returns forecast data for the next 120 hours for a specific location, using a locationKey obtained from another endpoint (e.g., city search or geoposition)

120 hours by location key › path Parameters

locationKey

string · required

A unique ID that designates a specific location. More information can be found here.

Example: 349727

120 hours by location key › query Parameters

format

string

A string value that specifies what type of format to provide the response.

Default: json

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

metric

boolean

A boolean value that specifies whether to return the data in metric units (true) or imperial units (false). More information can be found here.

Default: false

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

120 hours by location key › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

120 hours by location key › Responses

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast[]

API.Forecasts.Hourly.Entities.OpenAPI.HourlyForecast

DateTime

string · date-time · required

Datetime of the forecast displayed in ISO8601 format: (yyyy-mm-ddThh:mm:ss±hh:mm).

EpochDateTime

integer · int64 · required

Datetime of the forecast displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

WeatherIcon

integer · int32 · required

Numeric value representing an image that displays the IconPhrase.

IconPhrase

string · minLength: 1 · required

Phrase description of the forecast. Displayed in specified language.

HasPrecipitation

boolean · required

Boolean value that indicates the presence of any type of precipitation. Displays true if precipitation is present.

IsDaylight

boolean · required

Boolean value (true or false) that specifies whether or not it is daylight.

required

An object containing the forecasted temperature with a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

AccuLumenBrightnessIndex

number · float · required

An index value that indicates how bright the sunlight will be. Values are returned as a decimal from 0 to 10.00.

MobileLink

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's mobile site for the requested location.

Link

string · minLength: 1 · required

Link to hourly forecasts on AccuWeather's free site for the requested location.

PrecipitationType

string | null

Indicates if the precipitation is rain, snow, ice, or mixed. Only returned if HasPrecipitation is true.

PrecipitationIntensity

string | null

Indicates if the precipitation strength is light, moderate, or heavy. Only returned if HasPrecipitation is true.

The temperature at which the humidity in the air will begin to condense on surfaces. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

An object containing wind direction and speed information with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

An object containing information about the maximum short-burst wind speed with a rounded value in the specified units, Miles per hour or Kilometer per hour. The object may be NULL.

RelativeHumidity

integer | null · int32

A measure of water vapor in the air, expressed as a percentage of the amount needed for saturation.

IndoorRelativeHumidity

integer | null · int32

An object containing information about visibility distance with a rounded value in the specified units, Miles or Kilometer. The object may be NULL.

An object containing information about the cloud base elevation with a rounded value in the specified units, Feet or Meter. The object may be NULL.

UVIndex

integer · int32

A numerical value that indicates the sun's measured ultraviolet radiation strength.

UVIndexFloat

number · float

A decimal value that indicates the sun's measured ultraviolet radiation strength.

UVIndexText

string | null

Text associated with the UVIndex.

ThunderstormProbability

integer | null · int32

A percentage value representing the probability of a thunderstorm.

RainProbability

integer | null · int32

A percentage value representing the probability of rain.

SnowProbability

integer · int64

A percentage value representing the probability of snow.

IceProbability

integer | null · int32

A percentage value representing the probability of ice.

A measurement of total liquid for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of rain for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

A measurement of snow for the hour. An object with a rounded value in the specified units, Inch or Centimeter. The object may be NULL.

A measurement of ice for the hour. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

CloudCover

integer | null · int32

The percentage of cloud cover.

Soil water loss by evaporation and plant transpiration. An object with a rounded value in the specified units, Inch or Millimeter. The object may be NULL.

The sun's electromagnetic radiation (global horizontal irradiance) as measured at the Earth's surface. An object with a rounded value in Watts per square Meter. The object may be NULL.

The temperature combined with wind speed to express how it will feel. The object contains a rounded value in the specified units, Fahrenheit or Celsius. The object may be NULL.

GET/forecasts/v1/hourly/120hour/{locationKey}

curl https://dataservice.accuweather.com/forecasts/v1/hourly/120hour/:locationKey \
  --header 'Authorization: <api-key>'

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": "PrecipitationType",
    "PrecipitationIntensity": "PrecipitationIntensity",
    "IsDaylight": true,
    "Temperature": {},
    "RealFeelTemperature": {},
    "RealFeelTemperatureShade": {},
    "WetBulbTemperature": {},
    "WetBulbGlobeTemperature": {},
    "DewPoint": {},
    "Wind": {},
    "WindGust": {},
    "RelativeHumidity": 0,
    "IndoorRelativeHumidity": 0,
    "Visibility": {},
    "Ceiling": {},
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": "UVIndexText",
    "PrecipitationProbability": 0,
    "ThunderstormProbability": 0,
    "RainProbability": 0,
    "SnowProbability": 0,
    "IceProbability": 0,
    "TotalLiquid": {},
    "Rain": {},
    "Snow": {},
    "Ice": {},
    "CloudCover": 0,
    "Evapotranspiration": {},
    "SolarIrradiance": {},
    "AccuLumenBrightnessIndex": 0,
    "WindChillTemperature": {},
    "HeatIndex": {},
    "MobileLink": "MobileLink",
    "Link": "Link"
  }
]

json

application/json

Location Key Location Key