Skip to main content
GET
/
weather
Get current weather data
curl --request GET \
  --url https://api.openweathermap.org/data/2.5/weather
{
  "coord": {
    "lon": 2.3488,
    "lat": 48.8534
  },
  "weather": [
    {
      "id": 803,
      "main": "Clouds",
      "description": "broken clouds",
      "icon": "04d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 289.28,
    "feels_like": 288.7,
    "temp_min": 288.21,
    "temp_max": 291.69,
    "pressure": 1022,
    "humidity": 67
  },
  "visibility": 10000,
  "wind": {
    "speed": 2.57,
    "deg": 40
  },
  "clouds": {
    "all": 75
  },
  "dt": 1717406455,
  "sys": {
    "type": 2,
    "id": 2041230,
    "country": "FR",
    "sunrise": 1717386622,
    "sunset": 1717444055
  },
  "timezone": 7200,
  "id": 2988507,
  "name": "Paris",
  "cod": 200
}

Authorizations

​
appid
string
query
required

Query Parameters

​
lat
number
required

Latitude of the desired location

Required range: -90 <= x <= 90
​
lon
number
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

Successful response - Current weather data

​
coord
object
​
weather
object[]
​
base
string

Internal parameter

​
main
object
​
visibility
integer

Visibility (meters)

​
wind
object
​
clouds
object
​
rain
object | null
​
snow
object | null
​
dt
integer

Time of data calculation, in Unix time (UTC)

​
sys
object
​
timezone
integer

Shift in seconds from UTC

​
id
integer

City identifier

​
name
string

City name

​
cod
integer

API response status code