Current Conditions
Parameters
Request parameters
| Parameter | Description | Default | Required |
|---|---|---|---|
apikey | A unique code to access AccuWeather's APIs. | — | Yes |
version | Version of the API. | v1 | Yes |
locationkey | A unique ID that designates a specific location. Use the Locations API to search for the appropriate location key. | — | Yes |
format | The response data format. Currently only JSON is available. | JSON | No |
language | A string that indicates the language in which to return the resource. | en-us | No |
details | A boolean value that specifies whether or not to include extended information. | False | No |
getphotos | A boolean value that specifies whether or not to include photos representing the requested location and current weather. | False | No |
group | An integer value that specifies the number of cities to return. The available options are 50, 100, or 150. | — | Yes |
Response parameters
| Field | Type | Description |
|---|---|---|
LocalObservationDateTime | string | The date and time at which the data was collected, displayed in ISO 8601 format (yyyy-mm-ddThh:mm |
EpochTime | integer | 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 | string | A phrase describing the current weather conditions in the specified language. |
WeatherIcon | integer | A numeric value representing an image that displays the phrase returned in the WeatherText parameter. |
HasPrecipitation | boolean | A flag indicating the presence or absence of precipitation. A true response indicates precipitation, false indicates no precipitation. |
PrecipitationType | string | The type of precipitation, if any. Possible values are Rain, Snow, Ice, Mixed, or Null for no precipitation. |
LocalSource | object | Information specific to the local data source. This parameter is not returned if there is no local source information. |
LocalSource.Id | integer | A numeric identifier unique to the local data provider. |
LocalSource.Name | string | 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. |
LocalSource.WeatherCode | string | 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 | boolean | A boolean flag that indicates the day/night status. True at daytime, false at nighttime. |
Temperature | object | An object containing information about the observed air temperature at the requested location. |
Temperature.Metric.Value | number | The temperature's measured numerical value in Celsius. |
Temperature.Metric.Unit | string | The temperature measurement's unit type. |
Temperature.Metric.UnitType | integer | A unique numeric ID that designates the temperature measurement's unit type. This value can be used for unit translations. |
Temperature.Imperial.Value | number | The temperature's measured numerical value in Fahrenheit. |
Temperature.Imperial.Unit | string | The temperature measurement's unit type. |
Temperature.Imperial.UnitType | integer | A unique numeric ID that designates the temperature measurement's unit type. This value can be used for unit translations. |
RealFeelTemperature | object | AccuWeather's patented RealFeel® temperature. A temperature value that uses a variety of factors to determine how the temperature actually feels outside. |
RealFeelTemperature.Metric.Value | number | The RealFeel® temperature's numerical value in Celsius. |
RealFeelTemperature.Metric.Unit | string | The RealFeel® temperature value's unit type. |
RealFeelTemperature.Metric.UnitType | integer | A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations. |
RealFeelTemperature.Metric.Phrase | string | A brief description of how warm or cold the temperature actually feels outside. See RealFeel® Phrase Reference for the full list of phrases and temperature ranges. |
RealFeelTemperature.Imperial.Value | number | The RealFeel® temperature's numerical value in Fahrenheit. |
RealFeelTemperature.Imperial.Unit | string | The RealFeel® temperature value's unit type. |
RealFeelTemperature.Imperial.UnitType | integer | A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations. |
RealFeelTemperature.Imperial.Phrase | string | A brief description of how warm or cold the temperature actually feels outside. See RealFeel® Phrase Reference for the full list of phrases and temperature ranges. |
RealFeelTemperatureShade | object | 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. |
RealFeelTemperatureShade.Metric.Value | number | The RealFeel® shade temperature's numerical value in Celsius. |
RealFeelTemperatureShade.Metric.Unit | string | The RealFeel® temperature value's unit type. |
RealFeelTemperatureShade.Metric.UnitType | integer | A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations. |
RealFeelTemperatureShade.Metric.Phrase | string | A brief description of how warm or cold the temperature actually feels outside in the shade. See RealFeel® Phrase Reference for the full list of phrases. |
RealFeelTemperatureShade.Imperial.Value | number | The RealFeel® temperature's numerical value in Fahrenheit. |
RealFeelTemperatureShade.Imperial.Unit | string | The RealFeel® temperature value's unit type. |
RealFeelTemperatureShade.Imperial.UnitType | integer | A unique numeric ID that designates the temperature's unit type. This value can be used for unit translations. |
RealFeelTemperatureShade.Imperial.Phrase | string | A brief description of how warm or cold the temperature actually feels outside in the shade. See RealFeel® Phrase Reference for the full list of phrases. |
RelativeHumidity | integer | A measure of moisture in the air, expressed as a percentage of the maximum amount possible at the same temperature. |
IndoorRelativeHumidity | integer | 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 68F this is set to the outdoor relative humidity. |
DewPoint | object | The temperature at which the humidity in the air will begin to condense on surfaces. |
DewPoint.Metric.Value | number | The numerical dew point value in Celsius. |
DewPoint.Metric.Unit | string | The dew point's unit of measure. |
DewPoint.Metric.UnitType | integer | A unique numeric ID that designates the dew point's unit of measure. This value can be used for unit translations. |
DewPoint.Imperial.Value | number | The numerical dew point value in Fahrenheit. |
DewPoint.Imperial.Unit | string | The dew point's unit of measure. |
DewPoint.Imperial.UnitType | integer | A unique numeric ID that designates the dew point's unit of measure. This value can be used for unit translations. |
Wind | object | An object containing wind direction and speed information. |
Wind.Direction.Degrees | number | Wind direction in azimuth degrees from north (180 indicates a wind coming from the south). |
Wind.Direction.English | string | An English wind direction abbreviation. |
Wind.Direction.Localized | string | A wind direction abbreviation in the specified language. |
Wind.Speed.Metric.Value | number | The wind speed's measured numerical value in km/h. |
Wind.Speed.Metric.Unit | string | The wind speed measurement's unit type. |
Wind.Speed.Metric.UnitType | integer | A unique numeric ID that designates the wind speed measurement's unit type. This value can be used for unit translations. |
Wind.Speed.Imperial.Value | number | The wind speed's measured numerical value in mph. |
Wind.Speed.Imperial.Unit | string | The wind speed measurement's unit type. |
Wind.Speed.Imperial.UnitType | integer | A unique numeric ID that designates the wind speed measurement's unit type. This value can be used for unit translations. |
WindGust | object | An object containing information about the maximum short-burst wind speed. |
WindGust.Speed.Metric.Value | number | The maximum wind gust speed's measured numerical value in km/h. |
WindGust.Speed.Metric.Unit | string | The wind gust speed measurement's unit type. |
WindGust.Speed.Metric.UnitType | integer | A unique numeric ID that designates the wind gust speed measurement's unit type. This value can be used for unit translations. |
WindGust.Speed.Imperial.Value | number | The maximum wind gust speed's measured numerical value in mph. |
WindGust.Speed.Imperial.Unit | string | The wind gust speed measurement's unit type. |
WindGust.Speed.Imperial.UnitType | integer | A unique numeric ID that designates the wind gust speed measurement's unit type. This value can be used for unit translations. |
UVIndex | integer | A numerical value that indicates the sun's measured ultraviolet radiation strength. See UV Index Reference for category ranges. |
UVIndexFloat | number | A decimal value that indicates the sun's measured ultraviolet radiation strength. |
UVIndexText | string | A brief UV index status description. |
Visibility | object | An object containing information about visibility distance. |
Visibility.Metric.Value | number | The measured visibility distance in kilometers. |
Visibility.Metric.Unit | string | The visibility distance measurement's unit type. |
Visibility.Metric.UnitType | integer | A unique numeric ID that designates the visibility distance measurement's unit type. This value can be used for unit translations. |
Visibility.Imperial.Value | number | The measured visibility distance in miles. |
Visibility.Imperial.Unit | string | The visibility distance measurement's unit type. |
Visibility.Imperial.UnitType | integer | A unique numeric ID that designates the visibility distance measurement's unit type. This value can be used for unit translations. |
ObstructionsToVisibility | string | The visibility distance's limiting factor. |
CloudCover | integer | A number representing the percentage of the sky that is covered by clouds. May be NULL. |
Ceiling | object | An object containing information about the cloud base elevation. |
Ceiling.Metric.Value | number | The measured cloud ceiling in meters. |
Ceiling.Metric.Unit | string | The cloud ceiling measurement's unit type. |
Ceiling.Metric.UnitType | integer | A unique numeric ID that designates the cloud ceiling measurement's unit type. This value can be used for unit translations. |
Ceiling.Imperial.Value | number | The measured cloud ceiling in feet. |
Ceiling.Imperial.Unit | string | The cloud ceiling measurement's unit type. |
Ceiling.Imperial.UnitType | integer | A unique numeric ID that designates the cloud ceiling measurement's unit type. This value can be used for translations. |
Pressure | object | An object containing information about the measured air pressure at ground level. |
Pressure.Metric.Value | number | Rounded value of the pressure in mb. |
Pressure.Metric.Unit | string | Type of unit for the pressure value. |
Pressure.Metric.UnitType | integer | Numeric value that can be used for unit translations. |
Pressure.Imperial.Value | number | Rounded value of the pressure in inHg. |
Pressure.Imperial.Unit | string | Type of unit for the pressure value. |
Pressure.Imperial.UnitType | integer | Numeric value that can be used for unit translations. |
PressureTendency | object | Atmospheric pressure change. |
PressureTendency.LocalizedText | string | Description of the pressure tendency in specified language. |
PressureTendency.Code | string | F, S, R - pressure tendency code regardless of language. F=>Falling, S=>Steady, R=>Rising. |
Past24HourTemperatureDeparture | object | Departure from the temperature observed 24 hours ago. |
Past24HourTemperatureDeparture.Metric.Value | number | The departure value in Celsius. |
Past24HourTemperatureDeparture.Metric.Unit | string | The unit type. |
Past24HourTemperatureDeparture.Metric.UnitType | integer | A unique numeric ID for unit translations. |
Past24HourTemperatureDeparture.Imperial.Value | number | The departure value in Fahrenheit. |
Past24HourTemperatureDeparture.Imperial.Unit | string | The unit type. |
Past24HourTemperatureDeparture.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
ApparentTemperature | object | Perceived outdoor temperature from combined air temperature and humidity. Works across both hot and cold conditions, computed via the RAPP 16-term polynomial. |
ApparentTemperature.Metric.Value | number | The apparent temperature value in Celsius. |
ApparentTemperature.Metric.Unit | string | The unit type. |
ApparentTemperature.Metric.UnitType | integer | A unique numeric ID for unit translations. |
ApparentTemperature.Imperial.Value | number | The apparent temperature value in Fahrenheit. |
ApparentTemperature.Imperial.Unit | string | The unit type. |
ApparentTemperature.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
HeatIndex | object | Perceived outdoor temperature from combined air temperature and humidity. Valid in hot conditions (≥80 °F), computed via the NWS Rothfusz 9-term equation. |
HeatIndex.Metric.Value | number | The heat index value in Celsius. |
HeatIndex.Metric.Unit | string | The unit type. |
HeatIndex.Metric.UnitType | integer | A unique numeric ID for unit translations. |
HeatIndex.Imperial.Value | number | The heat index value in Fahrenheit. |
HeatIndex.Imperial.Unit | string | The unit type. |
HeatIndex.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
WindChillTemperature | object | Perceived air temperature on exposed skin due to wind. |
WindChillTemperature.Metric.Value | number | The wind chill temperature value in Celsius. |
WindChillTemperature.Metric.Unit | string | The unit type. |
WindChillTemperature.Metric.UnitType | integer | A unique numeric ID for unit translations. |
WindChillTemperature.Imperial.Value | number | The wind chill temperature value in Fahrenheit. |
WindChillTemperature.Imperial.Unit | string | The unit type. |
WindChillTemperature.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
WetBulbTemperature | object | The temperature to which air may be cooled by evaporating water into it at constant pressure until it reaches saturation. |
WetBulbTemperature.Metric.Value | number | The wet bulb temperature value in Celsius. |
WetBulbTemperature.Metric.Unit | string | The unit type. |
WetBulbTemperature.Metric.UnitType | integer | A unique numeric ID for unit translations. |
WetBulbTemperature.Imperial.Value | number | The wet bulb temperature value in Fahrenheit. |
WetBulbTemperature.Imperial.Unit | string | The unit type. |
WetBulbTemperature.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
WetBulbGlobeTemperature | object | 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. |
WetBulbGlobeTemperature.Metric.Value | number | The wet bulb globe temperature value in Celsius. |
WetBulbGlobeTemperature.Metric.Unit | string | The unit type. |
WetBulbGlobeTemperature.Metric.UnitType | integer | A unique numeric ID for unit translations. |
WetBulbGlobeTemperature.Imperial.Value | number | The wet bulb globe temperature value in Fahrenheit. |
WetBulbGlobeTemperature.Imperial.Unit | string | The unit type. |
WetBulbGlobeTemperature.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
Precip1hr | object | Amount of liquid water equivalent of precipitation that has fallen in the past hour. |
Precip1hr.Metric.Value | number | The precipitation value in mm. |
Precip1hr.Metric.Unit | string | The unit type. |
Precip1hr.Metric.UnitType | integer | A unique numeric ID for unit translations. |
Precip1hr.Imperial.Value | number | The precipitation value in in. |
Precip1hr.Imperial.Unit | string | The unit type. |
Precip1hr.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
PrecipitationSummary | object | Summary of precipitation amounts over the past 24 hours, in 3-hour increments. |
PrecipitationSummary.Precipitation | object | Deprecated. Please use the precipitation summary for a specific time span (e.g., PastHour, Past3Hours). Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
PrecipitationSummary.PastHour | object | Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
PrecipitationSummary.Past3Hours | object | Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
PrecipitationSummary.Past6Hours | object | Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
PrecipitationSummary.Past9Hours | object | Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
PrecipitationSummary.Past12Hours | object | Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
PrecipitationSummary.Past18Hours | object | Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
PrecipitationSummary.Past24Hours | object | Contains Metric (mm) and Imperial (in) objects with Value, Unit, UnitType. |
TemperatureSummary | object | Summary of temperature ranges for past 6, 12, and 24 hour periods. |
TemperatureSummary.Past6HourRange | object | Contains Minimum and Maximum with Metric and Imperial objects. |
TemperatureSummary.Past12HourRange | object | Contains Minimum and Maximum with Metric and Imperial objects. |
TemperatureSummary.Past24HourRange | object | Contains Minimum and Maximum with Metric and Imperial objects. |
MobileLink | string | Link to current conditions on AccuWeather's mobile site for the requested location. |
Link | string | Link to current conditions on AccuWeather's free site for the requested location. |
Top cities response parameters
Each entry in the top cities response array contains city metadata plus a basic subset of current conditions fields. For the full set of observation fields available via single-location endpoints, see Response parameters above.
| Field | Type | Description |
|---|---|---|
Key | string | The AccuWeather location key for the city. |
LocalizedName | string | The city's name in the requested language. |
EnglishName | string | The city's name in English. |
Country | object | An object containing country information. |
Country.ID | string | ISO 3166-1 alpha-2 country code. |
Country.LocalizedName | string | The country's name in the requested language. |
Country.EnglishName | string | The country's name in English. |
TimeZone | object | An object containing time zone information for the city. |
TimeZone.Code | string | Time zone abbreviation (e.g., EDT, BDT). |
TimeZone.Name | string | IANA time zone name (e.g., America/New_York, Asia/Dhaka). |
TimeZone.GmtOffset | number | The time zone's offset from GMT in hours. |
TimeZone.IsDaylightSaving | boolean | Whether the time zone is currently observing daylight saving time. |
TimeZone.NextOffsetChange | string | null | ISO 8601 date/time of the next DST transition, or null if none is scheduled. |
GeoPosition | object | An object containing the city's geographic position. |
GeoPosition.Latitude | number | The city's latitude in decimal degrees. |
GeoPosition.Longitude | number | The city's longitude in decimal degrees. |
GeoPosition.Elevation | object | An object containing the city's elevation. |
GeoPosition.Elevation.Metric.Value | number | The elevation value in meters. |
GeoPosition.Elevation.Metric.Unit | string | The metric elevation unit (m). |
GeoPosition.Elevation.Metric.UnitType | integer | A unique numeric ID for unit translations. |
GeoPosition.Elevation.Imperial.Value | number | The elevation value in feet. |
GeoPosition.Elevation.Imperial.Unit | string | The imperial elevation unit (ft). |
GeoPosition.Elevation.Imperial.UnitType | integer | A unique numeric ID for unit translations. |
LocalObservationDateTime | string | The date and time at which the data was collected, displayed in ISO 8601 format (yyyy-mm-ddThh:mm |
EpochTime | integer | The date and time at which the data was collected, displayed as the number of seconds since midnight UTC/GMT on January 1, 1970. |
WeatherText | string | A phrase describing the current weather conditions in the specified language. |
WeatherIcon | integer | A numeric value representing an image that displays the phrase returned in WeatherText. |
HasPrecipitation | boolean | A flag indicating the presence or absence of precipitation. true indicates precipitation, false indicates no precipitation. |
PrecipitationType | string | null | The type of precipitation, if any. Possible values are Rain, Snow, Ice, Mixed, or null for no precipitation. |
IsDayTime | boolean | A boolean flag that indicates the day/night status. true at daytime, false at nighttime. |
Temperature | object | An object containing information about the observed air temperature at the requested location. |
Temperature.Metric.Value | number | The temperature's measured numerical value in Celsius. |
Temperature.Metric.Unit | string | The temperature measurement's unit type. |
Temperature.Metric.UnitType | integer | A unique numeric ID that designates the temperature measurement's unit type. This value can be used for unit translations. |
Temperature.Imperial.Value | number | The temperature's measured numerical value in Fahrenheit. |
Temperature.Imperial.Unit | string | The temperature measurement's unit type. |
Temperature.Imperial.UnitType | integer | A unique numeric ID that designates the temperature measurement's unit type. This value can be used for unit translations. |
MobileLink | string | Link to current conditions on AccuWeather's mobile site for the requested location. |
Link | string | Link to current conditions on AccuWeather's site for the requested location. |
Last modified on