Skip to main content

Updates to HDA API query parameters for some Sentinel and CLMS datasets

In this article, find out which HDA query parameters have been renamed, removed, or added for Sentinel and CLMS datasets, and how to update your existing queries accordingly.

Alexandre avatar
Written by Alexandre
Updated yesterday

Context


Some Sentinel and Copernicus Monitoring Land Service (CLMS) datasets are affected by a change on their access method on provider's side. WEkEO is adjusting the Harmonised Data Access (HDA) to fetch them. Those changes can have an impact on your search queries.

⚠️ Action required starting from Tuesday, 24 February 2026, 18:00 CET: If you have existing HDA queries targeting the below-listed datasets, you may need to update them. Some query parameters have been renamed, some are no longer supported, and some new parameters are now available (see tables below).

Concerned datasets


The following datasets are affected by this change:

Changes summary tables


The tables below detail the parameter changes for each dataset. Use them to update your queries accordingly.

EO:JRC:DAT:CLMS

Old Parameter

New Parameter

Changes

dataset_id

dataset_id

Unchanged

bbox

bbox

Unchanged

productIdentifier

datasetIdentifier

Renamed

productType

productType

Unchanged

platform

platformShortName

Renamed

instrument

instrumentShortName

Renamed

status

(removed)

No longer supported

(none)

sortOrder

New parameter

startdate

startdate

Unchanged

enddate

enddate

Unchanged

(none)

fileFormat

No longer supported

startIndex

startIndex

Unchanged

itemsPerPage

itemsPerPage

Unchanged

EO:ESA:DAT:COP-DEM

Old parameter

New parameter

Changes

dataset_id

dataset_id

Unchanged

bbox

bbox

Unchanged

productIdentifier

(removed)

No longer supported

productType

productType

Unchanged

status

(removed)

No longer supported

(none)

sortOrder

New parameter

(none)

spatialResolution

New parameter

startdate

startdate

Unchanged

enddate

enddate

Unchanged

startIndex

startIndex

Unchanged

itemsPerPage

itemsPerPage

Unchanged

EO:ESA:DAT:SENTINEL-1

Old parameter

New parameter

Changes

dataset_id

dataset_id

Unchanged

bbox

bbox

Unchanged

productIdentifier

(removed)

No longer supported

productType

productType

Unchanged

processingLevel

processingLevel

Unchanged

platform

platformSerialIdentifier

Renamed

(none)

instrumentShortName

New parameter

sensorMode

(removed)

No longer supported

status

online

Renamed

timeliness

timeliness

Unchanged

polarisation

polarisationChannels

Renamed

swath

(removed)

No longer supported

(none)

orbitDirection

New parameter

(none)

relativeOrbitNumber

New parameter

(none)

sortOrder

New parameter

startdate

startdate

Unchanged

enddate

enddate

Unchanged

startIndex

startIndex

Unchanged

itemsPerPage

itemsPerPage

Unchanged

EO:ESA:DAT:SENTINEL-2

Old parameter

New parameter

Changes

dataset_id

dataset_id

Unchanged

bbox

bbox

Unchanged

productIdentifier

(removed)

No longer supported

productType

productType

Unchanged

tileId

(removed)

No longer supported

processingLevel

processingLevel

Unchanged

platform

platformSerialIdentifier

Renamed

instrument

instrumentShortName

Renamed

sensorMode

(removed)

No longer supported

status

(removed)

No longer supported

missionTakeId

(removed)

No longer supported

(none)

orbitDirection

New parameter

(none)

relativeOrbitNumber

New parameter

(none)

cloudCover

New parameter

(none)

sortOrder

New parameter

startdate

startdate

Unchanged

enddate

enddate

Unchanged

startIndex

startIndex

Unchanged

itemsPerPage

itemsPerPage

Unchanged

EO:ESA:DAT:SENTINEL-3

Old parameter

New parameter

Changes

dataset_id

dataset_id

Unchanged

bbox

bbox

Unchanged

productIdentifier

(removed)

No longer supported

productType

productType

Unchanged

processingLevel

processingLevel

Unchanged

platform

platformSerialIdentifier

Renamed

instrument

instrumentShortName

Renamed

status

(removed)

No longer supported

timeliness

timeliness

Unchanged

(none)

orbitDirection

New parameter

(none)

relativeOrbitNumber

New parameter

(none)

cloudCover

New parameter

(none)

sortOrder

New parameter

startdate

startdate

Unchanged

enddate

enddate

Unchanged

startIndex

startIndex

Unchanged

itemsPerPage

itemsPerPage

Unchanged

EO:ESA:DAT:SENTINEL-5P

Old parameter

New parameter

Changes

dataset_id

dataset_id

Unchanged

bbox

bbox

Unchanged

productIdentifier

(removed)

No longer supported

productType

productType

No longer supported

processingLevel

processingLevel

Unchanged

instrument

instrumentShortName

Renamed

status

(removed)

No longer supported

(none)

processingMode

New parameter

(none)

sortOrder

New parameter

(none)

orbitNumber

New parameter

startdate

startdate

Unchanged

enddate

enddate

Unchanged

startIndex

startIndex

Unchanged

itemsPerPage

itemsPerPage

Unchanged

Update queries


If your existing HDA query contains parameters that have been renamed, simply replace the old parameter name with the new one.

For example, for a Sentinel-1 query:

Before:

{
"dataset_id": "EO:ESA:DAT:SENTINEL-1",
"platform": "S1A",
"polarisation": "VV",
"startdate": "2024-01-01T00:00:00.000Z",
"enddate": "2024-01-31T23:59:59.999Z"
}

After:

{
"dataset_id": "EO:ESA:DAT:SENTINEL-1",
"platformSerialIdentifier": "S1A",
"polarisationChannels": "VV",
"startdate": "2024-01-01T00:00:00.000Z",
"enddate": "2024-01-31T23:59:59.999Z"
}

If your query uses a parameter that is no longer supported, simply remove it from your query. If that parameter was critical to your workflow, please contact the WEkEO User Support for guidance.

💡WEkEO Pro Tip: in any case, we highly recommend to use the Expert Data Viewer to build the query to use directly the correct parameters.

What's next?


Additional resources can be found in our Help Center. Should you require further assistance or wish to provide feedback, feel free to contact us through a chat session available in the bottom right corner of the page.

Did this answer your question?