List Collections

A list of all available OpenADB collections can be found on the OpenADB Website.

Code-Example:

# Import package
import openadbapi

# Initialize class
openadb_api = openadbapi.API()

# Apply Search Criteria
args = {}
# args['dataset'] = 'JASON3_L3_LRM_SSHALES_REP_20HZ_F_NTC_V56'
# args['mission'] = 'jason3'
# args['product'] = 'SSHALES'
# args['version'] = '56'
# args['start_date'] = '2001-01-01 00:00:00'
# args['end_date'] = '2030-01-01 00:00:00'
# args['start_cycle'] = '020'
# args['end_cycle'] = '910'

# List Collections
results = openadb_api.list_collections(args)

Search Arguments:

‘product’

Value	Name
SSH	Sea Surface Heights (SSH)
SLA	Sea Level Anomalies (SLA)
IDOT	Instantaneous Dynamic Ocean Topography (iDOT)
EOT	Empirical Ocean Tide Model (EOT)
VTEC	Vertical Total Electron Content (VTEC)
SSHALES	ALES Surface Heights (ALESSSH)

‘mission’

Value	Name
cryosat2	Cryosat-2
envisat	Envisat
ers1a	ERS-1A
ers1b	ERS-1B
ers1c	ERS-1C
ers1d	ERS-1D
ers1e	ERS-1E
ers1f	ERS-1F
ers1g	ERS-1G
ers2	ERS-2
geosat	Geosat
gfo	GFO
icesat	ICESat
jason1	Jason-1
jason2	Jason-2
jason3	Jason-3
poseidon	Poseidon
saral	SARAL
sentinel3a	Sentinel-3A
sentinel3b	Sentinel-3B
sentinel6a	Sentinel-6A
topex	Topex

‘version’

The product version is a 2-digit number representing an OpenADB product (e.g. 20, 33 or 40).

‘start_cycle’ and ‘end_cycle’

The cycle number of the start and end cycle is a 3-digit number (e.g. 001 or 132).

‘start_date’ and ‘end_date’

The date format of the start and end date ‘YYYY-MM-DD HH:MM:SS’ (e.g. ‘2025-11-12 06:00:52’).

Returned JSON response:

[
    {
        'collection': 'JASON3_L3_LRM_SSHALES_REP_20HZ_F_NTC_V56',
        'name': 'Jason-3 | L2 | ALES Sea Surface Heights | Version 56',
        'product': 'SSHALES',
        'mission': 'jason3',
        'start_date': '2016-02-17 10:29:37',
        'start_cycle': '001',
        'end_date': '2022-04-07 08:54:46',
        'end_cycle': '226',
        'processing_level': 'L3',
        'spatial_coverage': None,
        'timeliness': 'NTC',
        'version': '56'
        'description': 'Cross-calibrated along-track Sea Surface Height (SSH) '
            'measurements from ALES retracking. Version 56 contains '
            'global data optimized for coastal areas. It is corrected by '
            'NIC09 ionosphere, GPT+ wet troposphere, ERA5 dry '
            'troposphere, EOT20 ocean tides, HRET internal tides. '
            'Reference mission is Jason-3 GDR-F, and heights are with '
            'respect to the TOPEX ellipsoid. The dataset also provides '
            'DTU15 MSS, EOT20, and distance to coast information.',
    },
    ...
]