Are you getting 403 Forbidden errors? Read the FAQ and check your User-Agent header!



Locationforecast - Weather forecast for a specified place


This service delivers a full weather forecast for one location, that is, a forecast with several parameters for a nine-day period.

JSON format and variables

Version 2.0 defaults to JSON format for data. For an explanation of the various variables, see the Datamodel documentation. The JSON format is described in the General Forecast Format documentation.

XML format

For those who want to continue using their existing clients with a minimum of changes, you can also continue using the old XML format. This must be accessed via the classic method, like this:

Note that the msi parameter is now called altitude in 2.0.

The XML format is considered legacy, and as similar to 1.9 as possible except for additional time periods and the XML Schema URI. Future enhancements will primarily be added to the JSON format.

Also, some elements will be removed when version 1.9 is terminated, including the following elements:

    <temperatureProbability unit="probabilitycode" value="0"/>
    <windProbability unit="probabilitycode" value="0"/>
    <symbolProbability unit="probabilitycode" value="1"/>

Weather icons

Along with the new JSON format we also have a new set of weather icons, in PNG, SVG and PDF formats. They can be downloaded as a gzipped TAR archive using the WeatherIcon 2.0 service.

The filename (minus extension) corresponds to the symbol_code in the JSON format, including variations for day, night and polar day. This means there is no need for calculations or fetching data from the Sunrise service in order to present the correct weather icons. This has also been added to the XML as an attribute code to the symbol element:

    <symbol id="PartlyCloud" number="3" code="partlycloudy_day"></symbol>

Note: There is a typing error in lightssleetshowersandthunder and lightssnowshowersandthunder (extra "s" after "light"). Unfortunately, correcting this would mean breaking existing applications, so it has been postponed to the next version of weathericon/locationforecast.

Wind symbols

Wind direction denote where the wind is coming from, where 0° is north, 90° east, etc. For GUI applications use we suggest using arrows, like these:

0° (north)

90° (east)

180° (south)

270° (west)

UV index

The new format also includes UV radiation forecasts per location, to replace the old graphical UVforecast product. For those wanting UV maps these can be downloaded directly from CAMS.




JSON forecast with all values. This will shortly be expanded with probabilities, so that each variable will be repeated for a set of percentiles.


A shorter version with only the most used parameters (if you feel something is missing, please let us know)


The old XML format, now considered legacy. It matches the output of version 1.9 closely, but includes more time periods. Future new parameters will not be added to this version.



latitude in decimal degrees, mandatory


longtitude in decimal degrees, mandatory


Height above (or sometimes below) sea level in whole meters (integers). Optional but recommended for precise temperature values. When missing the internal topography model is used, which is rather course and may be incorrect in hilly terrain.

Note that this is the altitude of the ground surface! You cannot use this to ask for atmospheric predictions e.g. for aviation purposes.

Sample request URLs                         # JSON   # El Alto, Bolivia                         # Classic XML


Operational status for the model can be checked like this:


The XML Schema is available at

Schema for the JSON format is included in the OpenAPI spec:


Due to poor adherence to the identification requirements in the Terms of Service, we have implemented more stringent checks on sending a unique identifier in the User-Agent header. Any requests with a prohibited or missing User-Agent will receive a 403 Forbidden error.

Examples of banned User-Agents include:


While we only serve current forecasts via the API, you can find historical forecast model data in NetCDF format on

Due to licensing issues we can only distribute model data for the Nordic and Arctic regions. For global model data, please contact ECMWF.


Probabilities added: 2021-05-10

As a replacement for the deprecated Probabilityforecast product (to be removed on 2021-07-01), we have added some new variables to the `complete.json` forecast:


Version 0.9 EOL: 2021-03-01

After having been deprecated for 9 months, version 0.9 will finally be removed on March 1st, 2021.

XML updated with new symbol codes: 2020-12-14

Since Weathericon/1.1 is deprecated, we have added an attribute code to the symbol element, corresponding to the filename in Weathericon/2.0.

version 2.0 out of beta: 2020-06-17

version 2.0 : 2020-06-10

version 2.0 : 2020-04-02

version 2.0 : 2020-01-17

version 1.9 : 2014-05-20

phase out of version 1.5 : 2011-08-16

version 1.8 : 2010-06-10

version 1.7 : 2010-03-03

version 1.6 : 2009-01-15

version 1.5 : 2008-05-30

1.4 : 2007-12-03

1.3 : 2007-09-12

1.2 : 2007-06-15

1.1 : 2007-04-25

1.0 : 2007-05-15