Get current weather data

Retrieve the current weather conditions for a specified location using latitude and longitude coordinates.

GET /weather

Get current weather data

cURL

curl --request GET \
  --url 'https://api.openweathermap.org/data/2.5/weather?appid='

200

{
  "coord": {
    "lon": 123,
    "lat": 123
  },
  "weather": [
    {
      "id": 123,
      "main": "<string>",
      "description": "<string>",
      "icon": "<string>"
    }
  ],
  "base": "<string>",
  "main": {
    "temp": 123,
    "feels_like": 123,
    "pressure": 123,
    "humidity": 123,
    "temp_min": 123,
    "temp_max": 123,
    "sea_level": 123,
    "grnd_level": 123
  },
  "visibility": 123,
  "wind": {
    "speed": 123,
    "deg": 123,
    "gust": 123
  },
  "clouds": {
    "all": 123
  },
  "rain": {
    "1h": 123,
    "3h": 123
  },
  "snow": {
    "1h": 123,
    "3h": 123
  },
  "dt": 123,
  "sys": {
    "type": 123,
    "id": 123,
    "message": 123,
    "country": "<string>",
    "sunrise": 123,
    "sunset": 123
  },
  "timezone": 123,
  "id": 123,
  "name": "<string>",
  "cod": 123
}

Authorizations

appid · string · query · required

Query Parameters

lat · number<float> · required

Latitude of the desired location

Required range: -90 <= x <= 90

lon · number<float> · required

Longitude of the desired location

Required range: -180 <= x <= 180

mode · enum<string>

Response format.

Default is json if you don't use the mode parameter.

Available options: html, json, xml

units · enum<string>

Units of measurement:

• standard: Kelvin for temperature, meter/sec for wind speed and wind gust
• metric: Celsius for temperature, meter/sec for wind speed and wind gust
• imperial: Fahrenheit for temperature, miles/hour for wind speed and wind gust

Default is standard if you don't use the units parameter.

Available options: standard, metric, imperial

lang · string

Output language for weather description (weather.description) and city name (name) fields in the API response.

Available options:

• af: Afrikaans
• al: Albanian
• ar: Arabic
• az: Azerbaijani
• eu: Basque
• be: Belarusian
• bg: Bulgarian
• ca: Catalan
• zh_cn: Chinese Simplified
• zh_tw: Chinese Traditional
• hr: Croatian
• cs: Czech
• da: Danish
• nl: Dutch
• en: English
• fi: Finnish
• fr: French
• gl: Galician
• de: German
• el: Greek
• he: Hebrew
• hi: Hindi
• hu: Hungarian
• is: Icelandic
• id: Indonesian
• it: Italian
• ja: Japanese
• kr: Korean
• ku: Kurmanji (Kurdish)
• la: Latvian
• lt: Lithuanian
• mk: Macedonian
• no: Norwegian
• fa: Persian (Farsi)
• pl: Polish
• pt: Portuguese
• pt_br: Português Brasil
• ro: Romanian
• ru: Russian
• sr: Serbian
• sk: Slovak
• sl: Slovenian
• es: Spanish
• sv: Swedish
• se: Swedish
• th: Thai
• tr: Turkish
• uk: Ukrainian
• vi: Vietnamese
• zu: Zulu

Default is English if you don't use the lang parameter.

Response

200

application/json

Successful response - Current weather data

coord · object

Show child attributes

coord. lon · number

Longitude of the location

coord. lat · number

Latitude of the location

weather · object[]

Show child attributes

weather. id · integer

Weather condition identifier

weather. main · string

Group of weather parameters (Rain, Snow, Clouds etc.)

weather. description · string

Weather condition within the group

weather. icon · string

Weather icon identifier

base · string

Internal parameter

main · object

Show child attributes

main. temp · number

Temperature

main. feels_like · number

Temperature accounting for human perception

main. pressure · integer

Atmospheric pressure at sea level (hPa)

main. humidity · integer

Humidity (%)

main. temp_min · number

Minimum temperature at the moment (only for large megapolises and urban areas)

main. temp_max · number

Maximum temperature at the moment (only for large megapolises and urban areas)

main. sea_level · integer

Atmospheric pressure at sea level (hPa)

main. grnd_level · integer

Atmospheric pressure at ground level (hPa)

visibility · integer

Visibility (meters)

wind · object

Show child attributes

wind. speed · number

Wind speed

wind. deg · integer

Wind direction, degrees (meteorological)

wind. gust · number

Wind gust

clouds · object

Show child attributes

clouds. all · integer

Cloudiness (in percentage)

rain · object

Show child attributes

rain. 1h · number

Precipitation volume for the last 1 hour (mm)

rain. 3h · number

Precipitation volume for the last 3 hours (mm)

snow · object

Show child attributes

snow. 1h · number

Precipitation volume for the last 1 hour (mm)

snow. 3h · number

Precipitation volume for the last 3 hours (mm)

dt · integer

Time of data calculation, in Unix time (UTC)

sys · object

Show child attributes

sys. type · integer

Internal parameter

sys. id · integer

Internal parameter

sys. message · number

Internal parameter

sys. country · string

Country code. For example, FR for France.

sys. sunrise · integer

Sunrise time, in Unix time (UTC)

sys. sunset · integer

Sunset time, in Unix time (UTC)

timezone · integer

Shift in seconds from UTC

id · integer

City identifier

name · string

City name

cod · integer

API response status code