Core Weather

Location Key

Endpointhttps://dataservice.accuweather.com

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

object[]

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.

object · required

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

accuLumenBrightnessIndex

number · float · required

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.

object

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.

object

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.

object

CloudCover

integer | null · int32

The percentage of cloud cover.

object

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

curl --request GET \
  --url https://dataservice.accuweather.com/forecasts/v1/hourly/1hour/:locationKey \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": {},
    "PrecipitationIntensity": {},
    "IsDaylight": true,
    "Temperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperature": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperatureShade": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbGlobeTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "DewPoint": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Wind": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "WindGust": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "RelativeHumidity": {},
    "IndoorRelativeHumidity": {},
    "Visibility": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ceiling": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": {},
    "PrecipitationProbability": 0,
    "ThunderstormProbability": {},
    "RainProbability": {},
    "SnowProbability": 0,
    "IceProbability": {},
    "TotalLiquid": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Rain": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Snow": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ice": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "CloudCover": {},
    "Evapotranspiration": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "SolarIrradiance": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "accuLumenBrightnessIndex": 0,
    "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

object[]

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.

object · required

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

accuLumenBrightnessIndex

number · float · required

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.

object

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

object

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.

object

CloudCover

integer | null · int32

The percentage of cloud cover.

object

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

curl --request GET \
  --url https://dataservice.accuweather.com/forecasts/v1/hourly/12hour/:locationKey \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": {},
    "PrecipitationIntensity": {},
    "IsDaylight": true,
    "Temperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperature": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperatureShade": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbGlobeTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "DewPoint": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Wind": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "WindGust": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "RelativeHumidity": {},
    "IndoorRelativeHumidity": {},
    "Visibility": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ceiling": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": {},
    "PrecipitationProbability": 0,
    "ThunderstormProbability": {},
    "RainProbability": {},
    "SnowProbability": 0,
    "IceProbability": {},
    "TotalLiquid": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Rain": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Snow": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ice": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "CloudCover": {},
    "Evapotranspiration": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "SolarIrradiance": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "accuLumenBrightnessIndex": 0,
    "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

object[]

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.

object · required

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

accuLumenBrightnessIndex

number · float · required

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.

object

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

object

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.

object

CloudCover

integer | null · int32

The percentage of cloud cover.

object

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

curl --request GET \
  --url https://dataservice.accuweather.com/forecasts/v1/hourly/24hour/:locationKey \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": {},
    "PrecipitationIntensity": {},
    "IsDaylight": true,
    "Temperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperature": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperatureShade": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbGlobeTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "DewPoint": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Wind": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "WindGust": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "RelativeHumidity": {},
    "IndoorRelativeHumidity": {},
    "Visibility": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ceiling": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": {},
    "PrecipitationProbability": 0,
    "ThunderstormProbability": {},
    "RainProbability": {},
    "SnowProbability": 0,
    "IceProbability": {},
    "TotalLiquid": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Rain": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Snow": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ice": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "CloudCover": {},
    "Evapotranspiration": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "SolarIrradiance": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "accuLumenBrightnessIndex": 0,
    "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

object[]

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.

object · required

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

accuLumenBrightnessIndex

number · float · required

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.

object

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

object

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.

object

CloudCover

integer | null · int32

The percentage of cloud cover.

object

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

curl --request GET \
  --url https://dataservice.accuweather.com/forecasts/v1/hourly/72hour/:locationKey \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "DateTime": "2024-08-25T15:00:00Z",
    "EpochDateTime": 0,
    "WeatherIcon": 0,
    "IconPhrase": "IconPhrase",
    "HasPrecipitation": true,
    "PrecipitationType": {},
    "PrecipitationIntensity": {},
    "IsDaylight": true,
    "Temperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperature": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "RealFeelTemperatureShade": {
      "Phrase": "Phrase",
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "WetBulbGlobeTemperature": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "DewPoint": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Wind": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "WindGust": {
      "Speed": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Direction": {
        "Degrees": 0,
        "Localized": "Localized",
        "English": "English"
      }
    },
    "RelativeHumidity": {},
    "IndoorRelativeHumidity": {},
    "Visibility": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ceiling": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "UVIndex": 0,
    "UVIndexFloat": 0,
    "UVIndexText": {},
    "PrecipitationProbability": 0,
    "ThunderstormProbability": {},
    "RainProbability": {},
    "SnowProbability": 0,
    "IceProbability": {},
    "TotalLiquid": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Rain": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Snow": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "Ice": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "CloudCover": {},
    "Evapotranspiration": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "SolarIrradiance": {
      "UnitType": 0,
      "Value": 0,
      "Unit": "Unit"
    },
    "accuLumenBrightnessIndex": 0,
    "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

object[]

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.

object · required

PrecipitationProbability

integer · int32 · required

A percentage value representing the probability of precipitation.

accuLumenBrightnessIndex

number · float · required

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.

object

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

object

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.

object

CloudCover

integer | null · int32

The percentage of cloud cover.

object

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

curl --request GET \
  --url https://dataservice.accuweather.com/forecasts/v1/hourly/120hour/:locationKey \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

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

json

application/json

Location Key Location Key