Current Conditions API Parameters

Request parameters | Response parameters | Top cities response parameters

Current conditions API query string parameters

ParameterDescriptionDefault value
api Hostname for use in production applications: api.accuweather.com. N/A Required
apidev Hostname for use in development applications: apidev.accuweather.com. N/A Required
apikey A unique code to access AccuWeather's APIs. N/A Required
version Version of the API v1 Required
locationkey A unique ID that designates a specific location. Use the Locations API to search for the appropriate location key. N/A Required
format The response data format. Currently only JSON is available. JSON Optional
language A string that indicates the language in which to return the resource. en-us Optional
details A boolean value that specifies whether or not to include extended information. False Optional
getphotos A boolean value that specifies whether or not to include photos representing the requested location and current weather. False Optional
group An integer value that specifies the number of cities to return. The available options are 50, 100, or 150. N/A Required

Top of page

Current conditions API response parameters

ParameterDescription
LocalObservationDateTime The date and time at which the data was collected, displayed in ISO 8601 format (yyyy-mm-ddThh:mm:ss±hh:mm).
EpochTime 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.
WeatherText A phrase describing the current weather conditions in the specified language.
WeatherIcon A numeric value representing an image that displays the phrase returned in the WeatherText parameter.
HasPrecipitation A flag indicating the presence or absence of precipitation. A true response indicates precipitation, false indicates no precipitation.
PrecipitationType The type of precipitation, if any. Possible values are Rain, Snow, Ice, Mixed, or Null for no precipitation.
LocalSource Information specific to the local data source. This parameter is not returned if there is no local source information.
Id A numeric identifier unique to the local data provider.
Name The local data provider's name, displayed in the requested language if it is available. Otherwise the name is displayed in English or the language in which the name was provided.
WeatherCode A unique code provided by the local data provider. This code allows the current condition to be matched to icons provided by the local data provider instead of AccuWeather's icons.
IsDayTime A boolean flag that indicates the day/night status. True at daytime, false at nighttime.
Temperature An object containing information about the observed air temperature at the requested location.
Metric An object containing temperature information in Celcius.
Value The temperature's measured numerical value in Celsius.
Unit The temperature measurement's unit type.
UnitType A unique numeric ID that designates the temperature measurement's unit type. This value can be used for unit translations.
Imperial An object containing temperature information in Fahrenheit.
Value The temperature's measured numerical value in Fahrenheit.
Unit The temperature measurement's unit type.
UnitType A unique numeric ID that designates the temperature measurement's unit type. This value can be used for unit translations.
RealFeelTemperature™ AccuWeather's patented RealFeel™ temperature. A temperature value that uses a variety of factors to determine how the temperature actually feels outside.
Metric An object containing RealFeel™ temperature information in Celsius.
Value The RealFeel™ temperature's numerical value in Celsius.
Unit The RealFeel™ temperature value's unit type.
UnitType A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations.
Phrase A brief description of how warm or cold the temperature actually feels outside.
Imperial An object containing RealFeel™ temperature information in Fahrenheit.
Value The RealFeel™ temperature's numerical value in Fahrenheit.
Unit The RealFeel™ temperature value's unit type.
UnitType A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations.
Phrase A brief description of how warm or cold the temperature actually feels outside.
RealFeelTemperatureShade™ AccuWeather's patented RealFeel™ shade temperature. A temperature value that uses a variety of factors to determine how the temperature actually feels outside in the shade.
Metric An object containing temperature information in Celsius.
Value The RealFeel™ shade temperature's numerical value in Celsius.
Unit The RealFeel™ temperature value's unit type.
UnitType A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations.
Phrase A brief description of how warm or cold the temperature actually feels outside in the shade.
Imperial An object containing temperature information in Fahrenheit.
Value The RealFeel™ temperature's numerical value in Fahrenheit.
Unit The RealFeel™ temperature value's unit type.
UnitType A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations.
Phrase A brief description of how warm or cold the temperature actually feels outside in the shade.
RelativeHumidity A measure of moisture in the air, expressed as a percentage of the maximum amount possible at the same temperature.
IndoorRelativeHumidity 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 The temperature at which the humidity in the air will begin to condense on surfaces.
Metric An object containing dew point information in Celsius.
Value The numerical dew point value in Celsius.
Unit The dew point's unit of measure.
UnitType A unique numeric ID that designates the dew point's unit of measure. This value can be used for unit translations.
Imperial An object containing dew point information in Fahrenheit.
Value The numerical dew point value in Fahrenheit.
Unit The dew point's unit of measure.
UnitType A unique numeric ID that designates the dew point's unit of measure. This value can be used for unit translations.
Wind An object containing wind direction and speed information.
Direction An object containing wind direction in azimuth degrees.
Degrees Wind direction in azimuth degrees from north (180° indicates a wind coming from the south).
English An English wind direction abbreviation.
Localized A wind direction abbreviation in the specified language.
Speed An object containing information about wind speed.
Metric An object containing wind speed information in kilometers per hour (km/h).
Value The wind speed's measured numerical value in km/h.
Unit The wind speed measurement's unit type.
UnitType A unique numeric ID that designates the wind speed measurement's unit type. This value can be used for unit translations.
Imperial An object containing wind speed information in miles per hour (mph).
Value The wind speed's measured numerical value in mph.
Unit The wind speed measurement's unit type.
UnitType A unique numeric ID that designates the wind speed measurement's unit type. This value can be used for unit translations.
WindGust An object containing information about the maximum short-burst wind speed.
Speed An object containing information about the maximum wind gust speed.
Metric An object containing wind gust speed information in kilometers per hour (km/h).
Value The maximum wind gust speed's measured numerical value in km/h.
Unit The wind gust speed measurement's unit type.
UnitType A unique numeric ID that designates the wind gust speed measurement's unit type. This value can be used for unit translations.
Imperial An object containing wind gust speed information in miles per hour (mph).
Value The maximum wind gust speed's measured numerical value in mph.
Unit The wind gust speed measurement's unit type.
UnitType A unique numeric ID that designates the wind gust speed measurement's unit type. This value can be used for unit translations.
UVIndex A numerical value that indicates the sun's measured ultraviolet radiation strength.
UVIndexFloat A decimal value that indicates the sun's measured ultraviolet radiation strength.
UVIndexText A brief UV index status description.
Visibility An object containing information about visibility distance.
Metric An object containing visibility distance information in kilometers.
Value The measured visibility distance in kilometers.
Unit The visibility distance measurement's unit type.
UnitType A unique numeric ID that designates the visibility distance measurement's unit type. This value can be used for unit translations.
Imperial An object containing visibility distance information in miles.
Value The measured visibility distance in miles.
Unit The visibility distance measurement's unit type.
UnitType A unique numeric ID that designates the visibility distance measurement's unit type. This value can be used for unit translations.
ObstructionsToVisibility The visibility distance's limiting factor.
CloudCover A number representing the percentage of the sky that is covered by clouds. May be NULL.
Ceiling An object containing information about the cloud base elevation.
Metric An object containing information about the cloud ceiling in meters.
Value The measured cloud ceiling in meters.
Unit The cloud ceiling measurement's unit type.
UnitType A unique numeric ID that designates the cloud ceiling measurement's unit type. This value can be used for unit translations.
Imperial An object containing information about the cloud ceiling in feet.
Value The measured cloud ceiling in feet.
Unit The cloud ceiling measurement's unit type.
UnitType A unique numeric ID that designates the cloud ceiling measurement's unit type. This value can be used for translations.
Pressure An object containing information about the measured air pressure at ground level.
Metric mb
Value Rounded value of the Pressure in above units
Unit Type of unit for the Pressure value above
UnitType Numeric value that can be used for unit translations
Imperial inHg
Value Rounded value of the Pressure in above units
Unit Type of unit for the Pressure value above
UnitType Numeric value that can be used for unit translations
PressureTendency Atmospheric pressure change
LocalizedText Description of the pressure tendency in specified language
Code F, S, R - pressure tendency code regardless of language. F=>Falling, S=>Steady, R=>Rising
Past24HourTemperatureDeparture Departure from the temperature observed 24 hours ago.
Metric C
Value Rounded value of the Past24HourTemperatureDeparture in above units
Unit Type of unit for the Past24HourTemperatureDeparture value above
UnitType Numeric value that can be used for unit translations
Imperial F
Value Rounded value of the Past24HourTemperatureDeparture in above units
Unit Type of unit for the Past24HourTemperatureDeparture value above
UnitType Numeric value that can be used for unit translations
ApparentTemperature Perceived outdoor temperature caused by the combination of air temperature, relative humidity, and wind speed
Metric C
Value Rounded value of the ApparentTemperature in above units
Unit Type of unit for the ApparentTemperature value above
UnitType Numeric value that can be used for unit translations
Imperial F
Value Rounded value of the ApparentTemperature in above units
Unit Type of unit for the ApparentTemperature value above
UnitType Numeric value that can be used for unit translations
WindChillTemperature Perceived air temperature on exposed skin due to wind
Metric C
Value Rounded value of the WindChillTemperature in above units
Unit Type of unit for the WindChillTemperature value above
UnitType Numeric value that can be used for unit translations
Imperial F
Value Rounded value of the WindChillTemperature in above units
Unit Type of unit for the WindChillTemperature value above
UnitType Numeric value that can be used for unit translations
WetBulbTemperature The temperature to which air may be cooled by evaporating water into it at constant pressure until it reaches saturation.
Metric C
Value Rounded value of the WetBulbTemperature in above units
Unit Type of unit for the WetBulbTemperature value above
UnitType Numeric value that can be used for unit translations
Imperial F
Value Rounded value of the WetBulbTemperature in above units
Unit Type of unit for the WetBulbTemperature value above
UnitType Numeric value that can be used for unit translations
WetBulbGlobeTemperature 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.
Metric An object containing information about the wet bulb globe temperature in degrees Celcius.
Value Rounded value of the WetBulbGlobeTemperature in above units
Unit Type of unit for the WetBulbGlobeTemperature value above
UnitType Numeric value that can be used for unit translations
Imperial An object containing information about the wet bulb globe temperature in degrees Fahrenheit.
Value Rounded value of the WetBulbGlobeTemperature in above units
Unit Type of unit for the WetBulbGlobeTemperature value above
UnitType Numeric value that can be used for unit translations
Precip1hr Amount of liquid water equivalent of precipitation that has fallen in the past hour
Metric mm
Value Rounded value of the Precip1hr in above units
Unit Type of unit for the Precip1hr value above
UnitType Numeric value that can be used for unit translations
Imperial in
Value Rounded value of the Precip1hr in above units
Unit Type of unit for the Precip1hr value above
UnitType Numeric value that can be used for unit translations
PrecipitationSummary Summary of precipitation amounts over the past 24 hours, in 3-hour increments.
Precipitation Deprecated. Please use the precipitation summary for a specific time span.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
PastHour The amount of precipitation (liquid equivalent) that has fallen in the past hour. Contains Metric and Imperial Values.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Past3Hours The amount of precipitation (liquid equivalent) that has fallen in the past three hours. Contains Metric and Imperial Values.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Past6Hours The amount of precipitation (liquid equivalent) that has fallen in the past six hours. Contains Metric and Imperial Values.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Past9Hours The amount of precipitation (liquid equivalent) that has fallen in the past nine hours. Contains Metric and Imperial Values.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Past12Hours The amount of precipitation (liquid equivalent) that has fallen in the past 12 hours. Contains Metric and Imperial Values.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Past18Hours The amount of precipitation (liquid equivalent) that has fallen in the past 18 hours. Contains Metric and Imperial Values.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Past24Hours The amount of precipitation (liquid equivalent) that has fallen in the past 24 hours. Contains Metric and Imperial Values.
Metric Contains precipitation measurement values in metric units.
Value Rounded measurement of precipitation in metric units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
Imperial Contains precipitation measurement values in imperial units.
Value Rounded measurement of precipitation in imperial units.
Unit Type of measurement applicable to the precipitation value.
UnitType A unique numerical code assigned to the units for precipitation measurement.
TemperatureSummary Summary of temperature fluctuations over the past 6, 12, and 24 hours.
MobileLink Link to current conditions on AccuWeather's mobile site for the requested location
Link Link to current conditions on AccuWeather's free site for the requested location

Top of page

Top cities current conditions response parameters

ParameterDescription
Key Unique ID to search a location
LocalizedName Display name in local dialect set with language code in URL. Default is US English (us-en)
EnglishName Location name as displayed in English
Country
ID Unique ISO or Microsoft Localization Code for the country
LocalizedName Country name as displayed in the local dialect set with language code in the URL. If no language code is selected, the default is US English (us-en)
EnglishName Country name displayed in English
TimeZone
Code Official abbreviation code for designated Time Zone
Name Official name of designated Time Zone
GmtOffset Number of hours offset from local GMT time
IsDaylightSaving A “true” or “false” verification of whether a location is currently observing Day Light Saving time
NextOffsetChange Next time that daylight saving time changes
GeoPosition
Latitude Geographical coordinate that specifies the north-south position of a point on the Earth’s surface
Longitude Geographical coordinate that specifies the east-west position of a point on the Earth’s surface
Elevation
Metric m
Value Rounded value of elevation in above units
Unit Type of unit for the elevation value above
UnitType Numeric value that can be used for unit translations.
Imperial ft
Value Rounded value of elevation in above units
Unit Type of unit for the elevation value above
UnitType Numeric value that can be used for unit translations.
LocalObservationDateTime Datetime of the current observation displayed in ISO8601 format: yyyy-mm-ddThh:mm:ss±hh:mm
EpochTime Datetime of the current observation displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT)
WeatherText Phrase description of the current weather condition. Displayed in specified language
WeatherIcon Numeric value representing an image that displays the WeatherText
HasPrecipitation Flag indicating the presence or absence of precipitation. True indicates the presence of precipitation, false indicates the absence of precipitation.
PrecipitationType If precipitation is present, the type of precipitation will be returned. Possible values are Rain, Snow, Ice, or Mixed. Null in the absence of precipitation.
IsDayTime Flag indicating the time of day (true=>day, false=>night)
Temperature Temperature
Metric C
Value Rounded value of the Temperature in above units
Unit Type of unit for the Temperature value above
UnitType Numeric value that can be used for unit translations
Imperial F
Value Rounded value of the Temperature in above units
Unit Type of unit for the Temperature value above
UnitType Numeric value that can be used for unit translations
MobileLink Link to current conditions on AccuWeather's mobile site for the requested location
Link Link to current conditions on AccuWeather's free site for the requested location

Top of page