HDA API errors

Here we show a list of errors that can happen when trying to download WEkEO data via the HDA API, and how to avoid them.

David Bina avatar
Written by David Bina
Updated over a week ago

The Harmonized Data Access (HDA) API allows uniform access to the whole WEkEO catalogue, including subsetting and downloading functionalities.

However, some errors may occur during the download process.
In this article we list the main error messages and the steps to resolve them:

πŸ“ŒNote: this list may not be exhaustive.

List of errors


0 Items, 0 Volume

This message returned by the API requires a verification in the request itself to understand why there is no data (here is an example):

  • DateRange

    • Check if date_start is not greater than date_end

    • Check if the DateRange is included in the dataset with the following command:

      c.metadata(datasetID)

  • BoundingBox

    • Check if the BoundingBox values are in the right order (e.g. from Show API request in the Data Viewer using the AOI tool)

    • Check if the BoundingBox values correspond to a place where there is data in the Data Viewer

πŸ“ŒNote: if it's the same behavior for all the datasets, contact the WEkEO User Support.

Failed: No entry founds

Failed: No entry founds means that the parameters of your HDA query do not match a data set in the database. This may be a problem with the DateRange, the BoundingBox or some parameters that are not covered/available for that specific query.

Therefore, it is advisable to recheck the query in the Data Viewer.

Error 403 sporadically

After using the HDA API during some time (~1h) in a notebook, if you get a 403 error Forbidden Access, it means that the token does not renew correctly.

In that case, please update the latest version of the HDA API by running in a terminal:

pip install hda -U

Error 403 on all requests

Verify if you have any special character in your password (characters other than: ! @ # $ % & * in the password will result in a 403 Error Forbidden Access due to the security check from the API). If so, here are the steps to reset your password.

If you are facing an error message not included in the list or if the suggested workarounds do not resolve the issue, please copy the original request and the error code, and contact the WEkEO User Support below.

What's next?


We are user-driven and we implement users' suggestions, so feel free to contact us:

  • through a chat session available in the bottom right corner of the page

  • via e-mail to our support team (supportATwekeo.eu)

Did this answer your question?