# Guide

The Current Conditions API provides real-time weather observations for any location, including temperature, weather text, and precipitation data.

For full request and response field details, see [Current Conditions Parameters](/developers/current-conditions/parameters).

:::note{title="Base URLs"}

- **Production:** api.accuweather.com
- **Development:** apidev.accuweather.com

Examples below use the production host. Swap in apidev.accuweather.com for development.

:::

| Endpoint | Description |
|---|---|
| [Current conditions by location key](#current-conditions-by-locationkey) | Current weather for a specific location |
| [Historical current conditions (past 6 hours)](#historical-current-conditions-past-6-hours) | Past 6 hours of observations |
| [Historical current conditions (past 24 hours)](#historical-current-conditions-past-24-hours) | Past 24 hours of observations |
| [Top cities current conditions](#top-cities-current-conditions) | Current weather for top cities |

---

## Current conditions by location key

```
https://{baseUrl}/currentconditions/{version}/{locationKey}{.format}?apikey={your key}&language={language code}&details={true or false}&getphotos={true or false}
```

### Examples

**Basic request:**

```
https://api.accuweather.com/currentconditions/v1/335315.json?apikey={your key}
```

```json
[
  {
    "LocalObservationDateTime": "2018-11-01T14:11:00-04:00",
    "EpochTime": 1541095860,
    "WeatherText": "Cloudy",
    "WeatherIcon": 7,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": true,
    "Temperature": {
      "Metric": {
        "Value": 13.9,
        "Unit": "C",
        "UnitType": 17
      },
      "Imperial": {
        "Value": 57,
        "Unit": "F",
        "UnitType": 18
      }
    },
    "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us",
    "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us"
  }
]
```

**Request with photos:**

```
https://api.accuweather.com/currentconditions/v1/349727.json?apikey={your key}&getphotos=true
```

```json
[
  {
    "LocalObservationDateTime": "2018-11-01T14:11:00-04:00",
    "EpochTime": 1541095860,
    "WeatherText": "Partly sunny",
    "WeatherIcon": 3,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": true,
    "Temperature": {
      "Metric": {
        "Value": 20.6,
        "Unit": "C",
        "UnitType": 17
      },
      "Imperial": {
        "Value": 69,
        "Unit": "F",
        "UnitType": 18
      }
    },
    "Photos": [
      {
        "DateTaken": null,
        "Source": "iStockphoto/Thinkstock",
        "Description": "Architecture, Beautiful People, Beauty, Blue, Buil",
        "PortraitLink": "https://cityscapes.accuweather.com/cityscapes/USA/NewYork_146819736_P_L.jpg",
        "LandscapeLink": "https://cityscapes.accuweather.com/cityscapes/USA/NewYork_146819736_L_L.jpg"
      }
    ],
    "MobileLink": "https://m.accuweather.com/en/us/new-york-ny/10007/current-weather/349727?lang=en-us",
    "Link": "https://www.accuweather.com/en/us/new-york-ny/10007/current-weather/349727?lang=en-us"
  }
]
```

**Request with details in Spanish:**

```
https://api.accuweather.com/currentconditions/v1/335315.json?apikey={your key}&language=es&details=true
```

```json
[
  {
    "LocalObservationDateTime": "2025-09-26T09:27:00-04:00",
    "EpochTime": 1758893220,
    "WeatherText": "Mayormente nublado",
    "WeatherIcon": 6,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": true,
    "Temperature": {
      "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 }
    },
    "RealFeelTemperature": {
      "Metric": { "Value": 21.2, "Unit": "C", "UnitType": 17, "Phrase": "Agradable" },
      "Imperial": { "Value": 70.0, "Unit": "F", "UnitType": 18, "Phrase": "Agradable" }
    },
    "RealFeelTemperatureShade": {
      "Metric": { "Value": 18.0, "Unit": "C", "UnitType": 17, "Phrase": "Agradable" },
      "Imperial": { "Value": 64.0, "Unit": "F", "UnitType": 18, "Phrase": "Agradable" }
    },
    "RelativeHumidity": 100,
    "IndoorRelativeHumidity": 84,
    "DewPoint": {
      "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 }
    },
    "Wind": {
      "Direction": { "Degrees": 225, "Localized": "SO", "English": "SW" },
      "Speed": {
        "Metric": { "Value": 5.6, "Unit": "km/h", "UnitType": 7 },
        "Imperial": { "Value": 3.5, "Unit": "mi/h", "UnitType": 9 }
      }
    },
    "WindGust": {
      "Speed": {
        "Metric": { "Value": 5.6, "Unit": "km/h", "UnitType": 7 },
        "Imperial": { "Value": 3.5, "Unit": "mi/h", "UnitType": 9 }
      }
    },
    "UVIndex": 3,
    "UVIndexFloat": 2.6,
    "UVIndexText": "Moderado",
    "Visibility": {
      "Metric": { "Value": 16.1, "Unit": "km", "UnitType": 6 },
      "Imperial": { "Value": 10.0, "Unit": "mi", "UnitType": 2 }
    },
    "ObstructionsToVisibility": "",
    "CloudCover": 76,
    "Ceiling": {
      "Metric": { "Value": 12192.0, "Unit": "m", "UnitType": 5 },
      "Imperial": { "Value": 40000.0, "Unit": "ft", "UnitType": 0 }
    },
    "Pressure": {
      "Metric": { "Value": 1013.2, "Unit": "mb", "UnitType": 14 },
      "Imperial": { "Value": 29.92, "Unit": "inHg", "UnitType": 12 }
    },
    "PressureTendency": { "LocalizedText": "Constante", "Code": "S" },
    "Past24HourTemperatureDeparture": {
      "Metric": { "Value": -2.8, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": -5.0, "Unit": "F", "UnitType": 18 }
    },
    "ApparentTemperature": {
      "Metric": { "Value": 19.4, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 67.0, "Unit": "F", "UnitType": 18 }
    },
    "WindChillTemperature": {
      "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 }
    },
    "WetBulbTemperature": {
      "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 }
    },
    "WetBulbGlobeTemperature": {
      "Metric": { "Value": 19.1, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 66.0, "Unit": "F", "UnitType": 18 }
    },
    "Precip1hr": {
      "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
      "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
    },
    "PrecipitationSummary": {
      "Precipitation": {
        "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
      },
      "PastHour": {
        "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
      },
      "Past3Hours": {
        "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
      },
      "Past6Hours": {
        "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
      },
      "Past9Hours": {
        "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
      },
      "Past12Hours": {
        "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
      },
      "Past18Hours": {
        "Metric": { "Value": 1.1, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.04, "Unit": "in", "UnitType": 1 }
      },
      "Past24Hours": {
        "Metric": { "Value": 16.2, "Unit": "mm", "UnitType": 3 },
        "Imperial": { "Value": 0.64, "Unit": "in", "UnitType": 1 }
      }
    },
    "TemperatureSummary": {
      "Past6HourRange": {
        "Minimum": {
          "Metric": { "Value": 15.0, "Unit": "C", "UnitType": 17 },
          "Imperial": { "Value": 59.0, "Unit": "F", "UnitType": 18 }
        },
        "Maximum": {
          "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 },
          "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 }
        }
      },
      "Past12HourRange": { "..." : "..." },
      "Past24HourRange": { "..." : "..." }
    },
    "MobileLink": "http://www.accuweather.com/es/us/state-college-pa/16801/current-weather/335315",
    "Link": "http://www.accuweather.com/es/us/state-college-pa/16801/current-weather/335315"
  }
]
```

## Historical current conditions (past 6 hours) By LocationKey

```
https://{baseUrl}/currentconditions/{version}/{locationKey}/historical{.format}?apikey={your key}&language={language code}&details={true or false}
```

### Examples

**Basic request:**

```
https://api.accuweather.com/currentconditions/v1/335315/historical.json?apikey={your key}
```

```json
[
  {
    "LocalObservationDateTime": "2018-11-02T07:41:00-04:00",
    "EpochTime": 1541158860,
    "WeatherText": "Cloudy",
    "WeatherIcon": 7,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": false,
    "Temperature": {
      "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 }
    },
    "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us",
    "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us"
  },
  {
    "LocalObservationDateTime": "2018-11-02T07:03:00-04:00",
    "EpochTime": 1541156580,
    "WeatherText": "Cloudy",
    "WeatherIcon": 7,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": false,
    "Temperature": {
      "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 }
    },
    "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us",
    "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us"
  }
]
```

**Request with details:**

```
https://api.accuweather.com/currentconditions/v1/335315/historical.json?apikey={your key}&details=true
```

```json
[
  {
    "LocalObservationDateTime": "2025-09-26T12:58:00-04:00",
    "EpochTime": 1758905880,
    "WeatherText": "Mostly sunny",
    "WeatherIcon": 2,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": true,
    "Temperature": {
      "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 }
    },
    "RealFeelTemperature": {
      "Metric": { "Value": 25.0, "Unit": "C", "UnitType": 17, "Phrase": "Pleasant" },
      "Imperial": { "Value": 77.0, "Unit": "F", "UnitType": 18, "Phrase": "Pleasant" }
    },
    "RealFeelTemperatureShade": {
      "Metric": { "Value": 20.9, "Unit": "C", "UnitType": 17, "Phrase": "Pleasant" },
      "Imperial": { "Value": 70.0, "Unit": "F", "UnitType": 18, "Phrase": "Pleasant" }
    },
    "RelativeHumidity": 60,
    "IndoorRelativeHumidity": 60,
    "DewPoint": {
      "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 57.0, "Unit": "F", "UnitType": 18 }
    },
    "Wind": {
      "Direction": { "Degrees": 315, "Localized": "NW", "English": "NW" },
      "Speed": {
        "Metric": { "Value": 9.3, "Unit": "km/h", "UnitType": 7 },
        "Imperial": { "Value": 5.8, "Unit": "mi/h", "UnitType": 9 }
      }
    },
    "WindGust": {
      "Speed": {
        "Metric": { "Value": 11.3, "Unit": "km/h", "UnitType": 7 },
        "Imperial": { "Value": 7.0, "Unit": "mi/h", "UnitType": 9 }
      }
    },
    "UVIndex": 5,
    "UVIndexFloat": 4.6,
    "UVIndexText": "Moderate",
    "Visibility": {
      "Metric": { "Value": 16.1, "Unit": "km", "UnitType": 6 },
      "Imperial": { "Value": 10.0, "Unit": "mi", "UnitType": 2 }
    },
    "ObstructionsToVisibility": "",
    "CloudCover": 21,
    "Ceiling": {
      "Metric": { "Value": 12192.0, "Unit": "m", "UnitType": 5 },
      "Imperial": { "Value": 40000.0, "Unit": "ft", "UnitType": 0 }
    },
    "Pressure": {
      "Metric": { "Value": 1013.9, "Unit": "mb", "UnitType": 14 },
      "Imperial": { "Value": 29.94, "Unit": "inHg", "UnitType": 12 }
    },
    "PressureTendency": { "LocalizedText": "Steady", "Code": "S" },
    "Past24HourTemperatureDeparture": {
      "Metric": { "Value": 2.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 4.0, "Unit": "F", "UnitType": 18 }
    },
    "ApparentTemperature": {
      "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 }
    },
    "WindChillTemperature": {
      "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 }
    },
    "WetBulbTemperature": {
      "Metric": { "Value": 17.0, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 }
    },
    "WetBulbGlobeTemperature": {
      "Metric": { "Value": 21.4, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 71.0, "Unit": "F", "UnitType": 18 }
    },
    "Precip1hr": {
      "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 },
      "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 }
    },
    "PrecipitationSummary": {
      "Precipitation": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "PastHour":     { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past3Hours":   { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past6Hours":   { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past9Hours":   { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past12Hours":  { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past18Hours":  { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } },
      "Past24Hours":  { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }
    },
    "TemperatureSummary": {
      "Past6HourRange": {
        "Minimum": {
          "Metric": { "Value": 15.0, "Unit": "C", "UnitType": 17 },
          "Imperial": { "Value": 59.0, "Unit": "F", "UnitType": 18 }
        },
        "Maximum": {
          "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 },
          "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 }
        }
      },
      "Past12HourRange": { "...": "..." },
      "Past24HourRange": { "...": "..." }
    },
    "MobileLink": "http://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315",
    "Link": "http://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315"
  }
  // ...additional observations omitted
]
```

## Historical current conditions (past 24 hours) By LocationKey

```
https://{baseUrl}/currentconditions/{version}/{locationKey}/historical/24{.format}?apikey={your key}&language={language code}&details={true or false}
```

### Examples

**Basic request:**

```
https://api.accuweather.com/currentconditions/v1/335315/historical/24.json?apikey={your key}
```

```json
[
  {
    "LocalObservationDateTime": "2018-11-02T08:02:00-04:00",
    "EpochTime": 1541160120,
    "WeatherText": "Cloudy",
    "WeatherIcon": 7,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": true,
    "Temperature": {
      "Metric": { "Value": 12.8, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 55, "Unit": "F", "UnitType": 18 }
    },
    "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us",
    "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us"
  },
  {
    "LocalObservationDateTime": "2018-11-02T07:03:00-04:00",
    "EpochTime": 1541156580,
    "WeatherText": "Cloudy",
    "WeatherIcon": 7,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": false,
    "Temperature": {
      "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 }
    },
    "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us",
    "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us"
  },
  {
    "LocalObservationDateTime": "2018-11-02T06:03:00-04:00",
    "EpochTime": 1541152980,
    "WeatherText": "Light rain",
    "WeatherIcon": 12,
    "HasPrecipitation": true,
    "PrecipitationType": "Rain",
    "IsDayTime": false,
    "Temperature": {
      "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 }
    },
    "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us",
    "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us"
  }
  // ...up to 24 observation entries
]
```

**Request with details:**

```
https://api.accuweather.com/currentconditions/v1/335315/historical/24.json?apikey={your key}&details=true
```

Returns the full detailed response for each observation (the same field set as the 6-hour detailed response above), with up to 24 entries covering the past 24 hours.

## Current conditions for top cities

```
https://{baseUrl}/currentconditions/{version}/topcities/{group}{.format}?apikey={your key}&language={language code}
```

### Example

```
https://api.accuweather.com/currentconditions/v1/topcities/50.json?apikey={your key}
```

```json
[
  {
    "Key": "28143",
    "LocalizedName": "Dhaka",
    "EnglishName": "Dhaka",
    "Country": {
      "ID": "BD",
      "LocalizedName": "Bangladesh",
      "EnglishName": "Bangladesh"
    },
    "TimeZone": {
      "Code": "BDT",
      "Name": "Asia/Dhaka",
      "GmtOffset": 6,
      "IsDaylightSaving": false,
      "NextOffsetChange": null
    },
    "GeoPosition": {
      "Latitude": 23.7098,
      "Longitude": 90.40711,
      "Elevation": {
        "Metric": { "Value": 5, "Unit": "m", "UnitType": 5 },
        "Imperial": { "Value": 16, "Unit": "ft", "UnitType": 0 }
      }
    },
    "LocalObservationDateTime": "2018-11-02T18:20:00+06:00",
    "EpochTime": 1541161200,
    "WeatherText": "Mostly cloudy",
    "WeatherIcon": 38,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": false,
    "Temperature": {
      "Metric": { "Value": 27.8, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 82, "Unit": "F", "UnitType": 18 }
    },
    "MobileLink": "https://m.accuweather.com/en/bd/dhaka/28143/current-weather/28143?lang=en-us",
    "Link": "https://www.accuweather.com/en/bd/dhaka/28143/current-weather/28143?lang=en-us"
  },
  {
    "Key": "113487",
    "LocalizedName": "Kinshasa",
    "EnglishName": "Kinshasa",
    "Country": {
      "ID": "CD",
      "LocalizedName": "Democratic Republic of the Congo",
      "EnglishName": "Democratic Republic of the Congo"
    },
    "TimeZone": {
      "Code": "WAT",
      "Name": "Africa/Kinshasa",
      "GmtOffset": 1,
      "IsDaylightSaving": false,
      "NextOffsetChange": null
    },
    "GeoPosition": {
      "Latitude": -4.323,
      "Longitude": 15.308,
      "Elevation": {
        "Metric": { "Value": 280, "Unit": "m", "UnitType": 5 },
        "Imperial": { "Value": 918, "Unit": "ft", "UnitType": 0 }
      }
    },
    "LocalObservationDateTime": "2018-11-02T13:20:00+01:00",
    "EpochTime": 1541161200,
    "WeatherText": "Partly sunny",
    "WeatherIcon": 3,
    "HasPrecipitation": false,
    "PrecipitationType": null,
    "IsDayTime": true,
    "Temperature": {
      "Metric": { "Value": 28.9, "Unit": "C", "UnitType": 17 },
      "Imperial": { "Value": 84, "Unit": "F", "UnitType": 18 }
    },
    "MobileLink": "https://m.accuweather.com/en/cd/kinshasa/113487/current-weather/113487?lang=en-us",
    "Link": "https://www.accuweather.com/en/cd/kinshasa/113487/current-weather/113487?lang=en-us"
  }
  // ...remaining cities (up to `group`)
]
```

Available `group` values are **50**, **100**, or **150**.