Skip to main content
GET
/
weather
Get current weather data
curl --request GET \
  --url 'https://api.openweathermap.org/data/2.5/weather?appid='
{
  "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
}
Use this endpoint to fetch current weather conditions for a given location.

Authorizations

​
appid
string
query
required

Query Parameters

​
appid
string
required

API key for authentication

​
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, meters per second for wind speed and wind gust
  • metric: Celsius for temperature, meters per second for wind speed and wind gust
  • imperial: Fahrenheit for temperature, miles per 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:

  • sq: Albanian
  • af: Afrikaans
  • ar: Arabic
  • az: Azerbaijani
  • eu: Basque
  • be: Belarusian
  • bg: Bulgarian
  • ca: Catalan
  • zh_cn: Chinese Simplified
  • zh_tw: Chinese Traditional
  • hr: Croatian
  • cz: 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
  • sp, es: Spanish
  • sv, se: Swedish
  • th: Thai
  • tr: Turkish
  • ua, 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
​
snow
object
​
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