Frequently Asked Questions

General overview

About the company: what is OpenWeather?

OpenWeather (headquartered in London) is a team of IT-intellectuals that create pivotal products for business using climate data. For each point on the globe, OpenWeather provides hyperlocal minutely forecast, historical data, current state, and from short-term to annual forecasted weather data. All data is available via industry standard APIs.

OpenWeather Ltd. has more than 3 million customers including Fortune 500 companies and thousands of other businesses globally.

Get started

How to get an API key

In order to use our services, you need to get and use your personal API key in all your API requests. How to do it:

  1. Sign up and get an API key (APPID) on your account page.
  2. Verify your email address via a confirmation letter that will be sent to you.
  3. After verification, check your Inbox again to find our welcome email that contains your API key and important information.

Congratulations! Now you have a Free OpenWeather account and can start using our services. We highly recommend you to read the API documentation that explains how to use our APIs.

What types of data can I request?

For each point on the globe, OpenWeather provides hyperlocal minutely forecast, historical data, current state, and from short-term to annual and forecasted weather data. All data is available via industry standard APIs.

Current Weather and Forecasts Collection

How to get:

  • APIs (you can request data for geographic coordinates, ZIP codes, city name, city ID, number of cities)
  • Bulk Download (download already collected and regularly updated data for a list of global locations; available for premium subscriptions)

Historical Weather Collection

How to get:

  • On-the-fly bulks for customised lists of coordinates
  • Marketplace of prepared data sets (coordinates, cities, zip codes) - History Bulk (40+ years back), History Forecast Bulk (from 7 Oct 2017)
  • APIs to a timestamp / a period (subscriptions with different limits on calls and depth of archive)

Specialised products:

Detailed information about all our products can be found on the Pricing page.

Do I need to activate my API key?

Your API key will be activated automatically, up to 2 hours after your successful registration. We invite you to read the API documentation that explains how to use our APIs.

How can I use an API key in API calls?

To authorise a request from you and process it, we require you to use your unique API key in each API call.

In order to do this, add your API key as an appid parameter to the GET request, like in the following example:

api.openweathermap.org/data/2.5/weather?id=524901&appid=YOUR_API_KEY

Just use your API key instead of “YOUR_API_KEY” with your personal API key, it can be found in your personal account on the “API keys” page. You can also create additional API keys there.

Where can I find my API key(s) and generate additional ones?

Your API key can be found in your personal account on the “API keys” page. You can always create additional API keys there.

How many keys can I create?

You can create as many keys as you like. The total number of API calls for your account is counted based on all of your API keys together - please note this when choosing a subscription as they have various limits on API calls that can be made per day/per minute.

More information about subscription limits can be found on the Pricing page.

How to delete an API key?

You can delete unnecessary API keys but please note that your account with us should have at least 1 API key at any time.

To find your API key, go to your personal account and click the “API keys” tab

When you have more than 1 registered API key, there will be an option to delete an API key.

I need more information about the API call limits of my subscription.

The number of API calls you are allowed to make depends on the subscription you choose.

For users of Free or Startup plan, there are a few limitations:

  • If you use One Call API, you need to maintain your usage below both daily and per-month limits.
  • If you use individual APIs, you need to maintain your usage below both per-minute and per-month limits.

For other plans (Developer, Professional and Enterprise):

You need to maintain your usage below both per-minute and per-month limits.

What happens if I exceed the API calls limit of my subscription?

For Free plan

We will notify you and ask you to either migrate to a subscription plan that meets your needs or reduce a number of API calls accordingly. We expect you to take one or another action to avoid suspending of your account.

For users with paid plans

We always contact you to find a suitable solution for you.

How often is the weather data updated?

The frequency of weather data updates depends on your subscription. Please find more information on our “Detailed pricing” page, the “Weather API data update” part.

Subscriptions

I want to start one of the monthly subscriptions. Where do I begin?

It is easy and takes a couple of steps.

First, please create your account by signing up with your email and find API keys in the ‘API keys’ tab.

On the Pricing page, choose a proper subscription, click 'Subscribe'. Fill out a short billing form, check the details and complete your subscription. You can also subscribe from the settings page in the ‘Billing plans’ section.

For bank transfer or any other individual conditions , please contact our team.

Before you subscribe to our service, please read Terms and conditions of sale, Privacy policy, and Websites terms and conditions of use.

Does every plan provides access to historical data?

Within Current Weather and Forecasts Collection we provide only short-term historical data - for the previous 5 days via One Call API, for all subscriptions.

The Historical Weather Collection provides access to up to 40 years of historical data - please see our Pricing page.

How do I choose the right subscription?

The structure of our Pricing is quite simple.

The Current Weather and Forecasts Collection provides access to a range of products such as current weather, forecasts, short-term historical data, weather maps and other products.

We provide a completely Free plan. If its functionality is not enough for the size of your applications, we suggest a variety of subscriptions with ability to call APIs more intensively, higher availability of service (up to 99.9%) and premium level of support.

The Historical Weather Collection provides access to up 40 years’ worth of detailed historical weather data for any location. You can request data via APIs or by a one-time export of historical data for a list of locations.

If you need an advice on choosing the correct subscription, please contact our team for assistance.

Can I subscribe for more than one month?

Yes, we support the annual/biannual and other options. Please contact our team for details.

Can you customise an API?

We have a rich experience of cooperation with corporate customers providing them with an individual approach and personalised service. We are ready to discuss and estimate any customisations. It is possible for the Enterprise license holders. For more details, please contact us.

How to unsubscribe from your service?

If you would like to unsubscribe, please log in to your account on our website, then use the “Unsubscribe” button opposite your active plan in your personal account. After cancellation your subscription will still remain active until the end of the month for which you have paid.

If you pay by manual invoicing and would like to cancel your subscription, please contact our support team.

Pricing & payment process

Which payment methods we accept?

We accept payment either by credit or debit card. You can pay with most of credit or debit card such as Visa®, MasterCard®, American Express®, Maestro®, JCB®, Union Pay®. We accept bank transfer payments for premium accounts - Professional and Enterprise - and for long-term subscriptions. You can choose the way of payment in the subscription process.

Payments we do not accept

We do not accept cash or check payments.

How will I be charged for my subscription for recurring monthly payments?

For monthly recurring payments

You will be charged a fixed monthly fee based on the subscription plan you select on the “Pricing” page. In this case, the fee will be taken from your payment card. In your first month, you will be charged immediately after subscribing. The next payment will be a month later, and so on. The fee is subject to change, but we always notify you beforehand.

You can subscribe here.

For long-term subscriptions via manual invoicing

In case of manual invoicing, the payment process is discussed personally with each customer.

If you want to set up a long-term subscription, please contact our support team.

Is my payment secure?

All transactions made on the OpenWeather website are secure. We use HTTPS secure protocol over the website. We do not collect, store or process any of your payment details.

Where is my invoice?

You can find invoices and transaction history in the 'Payments' section of your settings.

Note that you need to add your company information in the 'Invoice info' tab in your personal account.

For bank transfer payments, our support team send invoices directly to your email. You can always contact us if you have any questions.

What happens after I pay for a subscription?

After receiving your payment, your API key will get activated and you will receive a confirmation email with API endpoints and guides.

How can I upgrade or downgrade my subscription plan?

If you pay by monthly recurring payments (via payment card):

Please log in to your account on our website, then use the “Subscribe” button underneath the desired plan in your personal account.

You will be charged immediately when you upgrade or downgrade your subscription. Note, that for your automatic subscription there is no any recalculation of payment that has already been done. To avoid double payment, we recommend you to change your subscription plan at the end of the month for which you have paid.

For example, if you have a Startup subscription and your billing payment date is the 15th day of each month, we would recommend to upgrade/downgrade your subscription on the 14th.

If you pay by manual invoice

You can сhange your subscription plan by contacting us.

How can I change my payment details?

If you would like to update your payment card details, please sign in and use this link: https://home.openweathermap.org/subscriptions/customer_portal.

If you want to switch the payment method (i.e from payment card to Wire transfer), please contact us for assistance and specify your account email.

How can I change information represented on the invoice (company info, address, etc.)?

Please sign in and use this link: https://home.openweathermap.org/invoice_info.

What happens if my payment fails?

If you have subscribed via our website and are paying for your monthly subscription automatically, our system will make several attempts (up to 4) to charge your payment card. These attempts will happen with a minimum of 1-day difference between each charging attempt.

In case we are not able to charge you after the final attempt, your subscription will be cancelled automatically, and you account will be suspended.

You have to contact us for help if you account was suspended.

Historical Weather Collection

What is the depth of historical weather data that you provide?

We offer historical weather data for any location for up to 40 years back. You can find more information about specific products in the Historical Weather Collection section of our “Pricing” page.

Personal account

Where can I change my password?

Your password can be changed in the “My profile/User settings” section of our website.

How can I reset my password?

You can reset your password on the “Sign in” page of our website by following the link after the question “Lost your password?”.

I want to delete my account; how should I do it?

You can always delete your account in the “My profile/Privacy centre” section of your settings.

Licence

Can I use OpenWeather’s APIs commercially?

You can freely use our products and data for non-commercial or commercial purposes by crediting OpenWeather (TM) as a weather data provider in your product. We provide our products under Creative Commons Attribution-ShareAlike 4.0 International licence (CC BY-SA 4.0).

Data and database are open and licensed by Open Data Commons Open Database License (ODbL).

For the holders of the Enterprise licence, we can provide service under individual conditions. Please contact us for details.

Technologies

What models do you use?

We provide data for any coordinates by utilising our proprietary convolutional neural network/machine learning model that we use for weather forecasting and historical data calculation. On different levels, different data sources are used (such as radars and a vast network of weather stations, along with data from global/local providers such as NOAA, Environment Canada and the Met Office). You can find out more about our approach here.

APIs

What are the minimum/maximum temperature fields in the Current Weather API and Forecast Weather API?

In the Current Weather API and Hourly Forecast API:

As it is a current weather data that reflect weather conditions only for the current moment, we add optional statistical parameters the temp_min and temp_max fields to show dispersion of temperature at this current moment. This is the minimum/maximum currently observed temperature or forecast temperature (within large megalopolises and urban areas).

In the 16-Day Forecast API and 30-Day Forecast

The list.temp.min and list.temp.max fields are minimum/maximum daily temperature, and show the minimum and maximum temperatures in the day.

Which time format and timezone are used?

OpenWeather uses Unix time and the UTC/GMT time zone for all API calls, including current weather, forecast and historical weather data. The timezone_offset parameter shows the shift in seconds from UTC. In a One Call API response, there is also a timezone parameter that shows the time zone name for the requested location.

Why I do not see some parameters in the API response?

If you do not see some of the parameters in your API response, it means that these weather phenomena just have not happened for the selected location at the time of measurement. Only actually measured or calculated data is displayed in an API response.

What is the format of the API response?

The JSON format is used by default. To get data in the XML or HTML format, just use “xml” or “html” for the mode parameter. The HTML format is available for Current Weather API only. For the One Call API, data is only available in the JSON format. If the mode parameter is omitted, the format is JSON by default.

Examples of API calls:

  • JSON: api.openweathermap.org/data/2.5/weather?q=London&{YOUR_API_KEY}
  • XML: api.openweathermap.org/data/2.5/weather?q=London&mode=xml&{YOUR_API_KEY}
  • HTML: api.openweathermap.org/data/2.5/weather?q=London&mode=html&{YOUR_API_KEY}

How can I switch between temperature units in API calls?

Temperature is available in Fahrenheit, Celsius and Kelvin units. Kelvin is used by default, with no need to use the units parameter in API calls.

For temperature in Fahrenheit, use "units=imperial".

For temperature in Celsius, use "units=metric".

You can find examples of API calls in the documentation for the service you are interested in.

A full list of all API parameters, with units, can be found here.

What are the weather condition codes and icons?

A list of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere including extreme conditions such as tornado or hurricane) can be found here.

You are free to use these icons in your own solutions.

Where can I find a list of City IDs?

For current and forecast products (Current API, Hourly Forecast API, Daily Forecast for 16 days, Climatic forecast for 30 days, 5 day/3 hour forecast data) can be downloaded here.

Please note that you can also make requests to our APIs by using coordinates, ZIP codes, etc. Please refer to documentation of specific API to see all available options.

API errors

API calls return an error 401

You can get the error 401 in the following cases:

API calls return an error 404

You can get this error when you specified the wrong city name, ZIP-code or city ID. For your reference, this list contains City name, City ID, Geographical coordinates of the city (lon, lat), Zoom, etc.

You can also get the error 404 if the format of your API request is incorrect. In this case, please review it and check for any mistakes. To see examples of correct API requests, please visit the Documentation of a specific API and read the examples of API calls there.

API calls return an error 429

You will get the error 429 if you are a user of a Free subscription and make more than 60 API calls per minute (surpassing the limit of your subscription).

Please consider upgrading to a subscription plan that meets your needs or reduce the number of API calls in accordance with the limits.

API calls return errors 500, 502, 503 or 504

In case you receive one of the following errors 500, 502, 503 or 504 please contact us for assistance. Please enclose an example of your API request that receives this error into your email to let us analyze it and find a solution for you promptly.