Core Weather

Location Key

Endpoint:https://dataservice.accuweather.com

Current conditions by location key

GET

https://dataservice.accuweather.com

/currentconditions/v1/{locationKey}

Retrieves the current weather conditions for a specific location, using a locationKey obtained from another endpoint (e.g., city search or geoposition)

Current conditions by location key › path Parameters

locationKeystring · required
A unique ID that designates a specific location. More information can be found here.
Example: 349727

Current conditions by location key › query Parameters

formatstring
A string value that specifies what type of format to provide the response.
Default: json
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
getPhotosboolean
A boolean value that specifies whether or not to include photos representing the requested location and current weather.
Default: false

Current conditions by location key › Headers

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

Current conditions by location key › Responses

LocalObservationDateTimestring · date-time · required
The date and time at which the data was collected, displayed in ISO 8601 format (yyyy-mm-ddThh:mm:ss±hh:mm).
EpochTimeinteger · int64 · required
The date and time at which the data was collected, displayed as the number of seconds that have elapsed since midnight UTC/GMT on January 1, 1970.
WeatherTextstring · minLength: 1 · required
A phrase describing the current weather conditions in the specified language.
WeatherIconinteger · int32 · required
A numeric value representing an image that displays the phrase returned in the WeatherText parameter.
HasPrecipitationboolean · required
A flag indicating the presence or absence of precipitation. A true response indicates precipitation, false indicates no precipitation.
PrecipitationTypestring · minLength: 1 · required
The type of precipitation, if any. Possible values are Rain, Snow, Ice, Mixed, or Null for no precipitation.
IsDayTimeboolean · required
A boolean flag that indicates the day/night status. True at daytime, false at nighttime.
Temperaturerequired
An object containing information about the observed air temperature at the requested location with a rounded value for Fahrenheit and Celsius. The object may be NULL.
MobileLinkstring · minLength: 1 · required
Link to current conditions on AccuWeather's mobile site for the requested location.
Linkstring · minLength: 1 · required
Link to current conditions on AccuWeather's free site for the requested location.

RealFeelTemperature | null
An object containing the AccuWeather patented RealFeel™ temperature with a rounded value for Fahrenheit or Celsius. The object may be NULL.
RealFeelTemperatureShade | null
An object containing the AccuWeather patented RealFeel™ shade temperature with a rounded value for Fahrenheit or Celsius. The object may be NULL.
RelativeHumidityinteger · int32
A measure of moisture in the air, expressed as a percentage of the maximum amount possible at the same temperature.
IndoorRelativeHumidityinteger | 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.
DewPoint | null
The temperature at which the humidity in the air will begin to condense on surfaces. The object contains a rounded value for Fahrenheit and Celsius. The object may be NULL.
Wind | null
An object containing wind direction and speed information with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.
WindGust | null
An object containing information about the maximum short-burst wind speed with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.
UVIndexinteger | null · int32
A numerical value that indicates the sun's measured ultraviolet radiation strength.
UVIndexFloatnumber | null · float
A decimal value that indicates the sun's measured ultraviolet radiation strength.
UVIndexTextstring | null
A brief UV index status description.
Visibility | null
An object containing information about visibility distance with a rounded value for Miles and Kilometer. The object may be NULL.
ObstructionsToVisibilitystring | null
The visibility distance's limiting factor.
CloudCoverinteger | null · int32
A number representing the percentage of the sky that is covered by clouds. May be NULL.
Ceiling | null
An object containing information about the cloud base elevation with a rounded value for Feet and Meter. The object may be NULL.
Pressure | null
An object containing information about the measured air pressure at ground level with a rounded value for Inches of Mercury and Millibar. The object may be NULL.
PressureTendency | null
An object containing information about the atmospheric pressure change.
Past24HourTemperatureDeparture | null
An object containing information about departure from the temperature observed 24 hours ago with rounded values for Fahrenheit and Celsius. The object may be NULL.
WindChillTemperature | null
An object containing information about perceived air temperature on exposed skin due to wind with rounded values for Fahrenheit and Celsius. The object may be NULL.
WetBulbTemperature | null
The temperature to which air may be cooled by evaporating water into it at constant pressure until it reaches saturation. An object containing a rounded value for Fahrenheit and Celsius. The object may be NULL.
WetBulbGlobeTemperature | 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. An object containing a rounded value for Fahrenheit and Celsius. The object may be NULL.
Precip1hr | null
Amount of liquid water equivalent of precipitation that has fallen in the past hour. An object containing a rounded value for Inch and Millimeter. The object may be NULL.
PrecipitationSummary | null
Summary of precipitation amounts over the past 24 hours, in 3-hour increments.
TemperatureSummary | null
Summary of temperature fluctuations over the past 6, 12, and 24 hours.
ApparentTemperature | null
Perceived outdoor temperature caused by the combination of air temperature, relative humidity, and wind speed.

Top Cities

Core Weather

Location Key

Endpoint:https://dataservice.accuweather.com

Current conditions by location key

GET

https://dataservice.accuweather.com

/currentconditions/v1/{locationKey}

Retrieves the current weather conditions for a specific location, using a locationKey obtained from another endpoint (e.g., city search or geoposition)

Current conditions by location key › path Parameters

locationKeystring · required
A unique ID that designates a specific location. More information can be found here.
Example: 349727

Current conditions by location key › query Parameters

formatstring
A string value that specifies what type of format to provide the response.
Default: json
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
getPhotosboolean
A boolean value that specifies whether or not to include photos representing the requested location and current weather.
Default: false

Current conditions by location key › Headers

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

Current conditions by location key › Responses

LocalObservationDateTimestring · date-time · required
The date and time at which the data was collected, displayed in ISO 8601 format (yyyy-mm-ddThh:mm:ss±hh:mm).
EpochTimeinteger · int64 · required
The date and time at which the data was collected, displayed as the number of seconds that have elapsed since midnight UTC/GMT on January 1, 1970.
WeatherTextstring · minLength: 1 · required
A phrase describing the current weather conditions in the specified language.
WeatherIconinteger · int32 · required
A numeric value representing an image that displays the phrase returned in the WeatherText parameter.
HasPrecipitationboolean · required
A flag indicating the presence or absence of precipitation. A true response indicates precipitation, false indicates no precipitation.
PrecipitationTypestring · minLength: 1 · required
The type of precipitation, if any. Possible values are Rain, Snow, Ice, Mixed, or Null for no precipitation.
IsDayTimeboolean · required
A boolean flag that indicates the day/night status. True at daytime, false at nighttime.
Temperaturerequired
An object containing information about the observed air temperature at the requested location with a rounded value for Fahrenheit and Celsius. The object may be NULL.
MobileLinkstring · minLength: 1 · required
Link to current conditions on AccuWeather's mobile site for the requested location.
Linkstring · minLength: 1 · required
Link to current conditions on AccuWeather's free site for the requested location.

RealFeelTemperature | null
An object containing the AccuWeather patented RealFeel™ temperature with a rounded value for Fahrenheit or Celsius. The object may be NULL.
RealFeelTemperatureShade | null
An object containing the AccuWeather patented RealFeel™ shade temperature with a rounded value for Fahrenheit or Celsius. The object may be NULL.
RelativeHumidityinteger · int32
A measure of moisture in the air, expressed as a percentage of the maximum amount possible at the same temperature.
IndoorRelativeHumidityinteger | 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.
DewPoint | null
The temperature at which the humidity in the air will begin to condense on surfaces. The object contains a rounded value for Fahrenheit and Celsius. The object may be NULL.
Wind | null
An object containing wind direction and speed information with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.
WindGust | null
An object containing information about the maximum short-burst wind speed with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.
UVIndexinteger | null · int32
A numerical value that indicates the sun's measured ultraviolet radiation strength.
UVIndexFloatnumber | null · float
A decimal value that indicates the sun's measured ultraviolet radiation strength.
UVIndexTextstring | null
A brief UV index status description.
Visibility | null
An object containing information about visibility distance with a rounded value for Miles and Kilometer. The object may be NULL.
ObstructionsToVisibilitystring | null
The visibility distance's limiting factor.
CloudCoverinteger | null · int32
A number representing the percentage of the sky that is covered by clouds. May be NULL.
Ceiling | null
An object containing information about the cloud base elevation with a rounded value for Feet and Meter. The object may be NULL.
Pressure | null
An object containing information about the measured air pressure at ground level with a rounded value for Inches of Mercury and Millibar. The object may be NULL.
PressureTendency | null
An object containing information about the atmospheric pressure change.
Past24HourTemperatureDeparture | null
An object containing information about departure from the temperature observed 24 hours ago with rounded values for Fahrenheit and Celsius. The object may be NULL.
WindChillTemperature | null
An object containing information about perceived air temperature on exposed skin due to wind with rounded values for Fahrenheit and Celsius. The object may be NULL.
WetBulbTemperature | null
The temperature to which air may be cooled by evaporating water into it at constant pressure until it reaches saturation. An object containing a rounded value for Fahrenheit and Celsius. The object may be NULL.
WetBulbGlobeTemperature | 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. An object containing a rounded value for Fahrenheit and Celsius. The object may be NULL.
Precip1hr | null
Amount of liquid water equivalent of precipitation that has fallen in the past hour. An object containing a rounded value for Inch and Millimeter. The object may be NULL.
PrecipitationSummary | null
Summary of precipitation amounts over the past 24 hours, in 3-hour increments.
TemperatureSummary | null
Summary of temperature fluctuations over the past 6, 12, and 24 hours.
ApparentTemperature | null
Perceived outdoor temperature caused by the combination of air temperature, relative humidity, and wind speed.

Top Cities