# 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:ss+/-hh: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](/developers/reference/realfeel-phrase) 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](/developers/reference/realfeel-phrase) 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](/developers/reference/realfeel-phrase) 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](/developers/reference/realfeel-phrase) 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](/developers/reference/uv-index) 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](#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:ss+/-hh: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. |