Get a list of Observation objects.

### Available end points:

- `/observations/` - Will list all Results in the database
- `/observations.json` - Will return all Results in json format. This can
also be achieved by using the accept header. `application/json`
- `/observations/<object_id>/` - Returns Results object with that id

### Available Methods:

- `GET`
- `HEAD`

### Available filters:

- `title`
- `uuid`
- `keywords`
- `status`
- `result_field`
- `discoveryKeywords`
- `updateFrequency`
- `nonGeographicFlag`
- `publicationState`
- `permissions`

### How to use filters:

These filters can be used like django query filters using __ for related model relationships.

- `/observations/?uuid=d594d53df2612bbd89c2e0e770b5c1a0`
- `/observations/?status=completed`
- `/observations/?results_field__dataPath__startswith=/neodc/esacci`
- `/observations/?discoveryKeywords__name=ESACCI`
- `/observations/?nonGeographicFlag=True`

Filters can be stacked to build an 'AND' relationship. E.g.

- `/observations/?publicationState__in=published,citable&nonGeographicFlag=True`
- `/observations/?publicationState__in=published,citable&discoveryKeyword__name=NDGO0003`

GET /api/v2/observations/43387/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 43387,
    "uuid": "bc13bb02a958449aac139853c4638f32",
    "title": "ESA Snow Climate Change Initiative (Snow_cci): Daily global Snow Cover Fraction - viewable snow (SCFV) from MODIS (2000 - 2023), version 4.0",
    "abstract": "This dataset provides daily Snow Cover Fraction Viewable from above (SCFV) derived from Terra MODIS observations, produced within the ESA Climate Change Initiative Snow project.\r\n\r\nSCFV expresses the proportion of land area within each about 1 km x 1 km pixel that is covered by snow. SCFV represents snow viewable from above, whether on the forest canopy or on the ground in clear-cut or non-forested areas. The SCFV is given in percentage (%) per pixel.\r\n\r\nThis SCFV product is available at about 1 km pixel size for global land areas except the Antarctica and Greenland ice sheets and permanent snow and ice areas. The coastal zones of Greenland are included. The SCFV time series spans 24 February 2000 to 31 December 2023.\r\n\r\nThis SCFV product is based on Moderate resolution Imaging Spectroradiometer (MODIS) data on-board the Terra satellite. For the SCFV product generation from MODIS, multiple reflective and emissive spectral bands are used. In a first step, clouds are masked using an adapted version of the Simple Cloud Detection Algorithm (SCDA) (Metsämäki et al., 2015).   For all remaining pixels, the snow_cci SCFV retrieval method is applied, using spectral bands centred at about 0.55 µm and 1.6 µm, and an emissive band centred at about 11 µm. The snow_cci snow cover mapping algorithm is a two-step approach that first identifies pixels which are assessed as snow free, followed by SCFV retrieval for remaining pixels. \r\nPermanent snow/ice and water bodies are masked using the Land Cover CCI 2000 dataset, supplemented by a manually mapped salt-lake mask.    Per-pixel uncertainty is provided in the ancillary variable as an unbiased Root Mean Square Error (RMSE) for all observed land pixels.\r\n\r\nCompared with SCFV CRDP v3.0 (https://catalogue.ceda.ac.uk/uuid/e955813b0e1a4eb7af971f923010b4a3/) the SCFV CRDP v4.0 includes the following improvements: \r\n•\tmore permissive pre-classification allowing more pixels to enter the SCFV retrieval; \r\n•\tcorrection function applied to spectral reflectance for improved SCFV retrieval at low solar illumination conditions;\r\n•\tupdated spectral reflectance layers for snow free ground and snow free forest to improve SCFV retrieval;\r\n•\tupdated uncertainty estimation to account for the changes in the SCFV retrieval;\r\n•\timproved merging method for generating daily global SCFV products;\r\n•\tupdated salt lake mask;\r\n•\textended time series, to December 2023.\r\n\r\nThere are several days with no MODIS acquisitions in the years 2000, 2001, 2002, 2003, 2008, 2016 and 2022. In addition, on multiple days between 2000 and 2006 and in 2023, as well as on single days in 2012, 2015 and 2016, 2018, and 2020, the available MODIS data exhibit either limited spatial coverage, or corruption during data download. SCFV products are provided for all of these days, but they contain data gaps.\r\n\r\nThe SCFV product is aimed to support cryosphere and climate research applications, including variability and trend analyses, climate modelling and studies in hydrology, meteorology, and ecology.\r\nENVEO leads the SCFV product development and product generation from MODIS data, with contributions on the product development from Syke.",
    "keywords": "ESA, CCI, Snow, Snow Cover Fraction",
    "publicationState": "citable",
    "dataPublishedTime": "2025-12-03T17:12:36",
    "doiPublishedTime": "2025-12-03T17:24:38",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/45113/?format=api",
        "dataPath": "/neodc/esacci/snow/data/scfv/MODIS/v4.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 876520536031,
        "numberOfFiles": 8644,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12833/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2614/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/32072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61130/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61131/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63201/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63202/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74106/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74107/?format=api"
    ],
    "dataLineage": "The snow_cci SCFV products from MODIS are based on the MODIS/Terra Calibrated Radiances 5-Min L1B Swath 1km (MOD021KM) and the MODIS/Terra Geolocation Fields 5-Min L1A Swath 1km (MOD03) Collection 6.1 data sets, provided by NASA.\r\nThe snow_cci SCF processing chain for MODIS includes the masking of clouds, the pre-classification of largely snow free areas, and the classification of snow cover fraction per pixel for all remaining observed pixels. Permanent snow and ice areas as well as water bodies are masked in the SCFV products using the corresponding classes from the Land Cover CCI map of the year 2000 as auxiliary layers. Salt lakes are masked based on a manual delineation of such areas from Terra MODIS data. \r\nSCFV products from individual tiles are merged into daily global SCFV products.\r\nAll SCFV products are prepared according to the CCI data standards.\r\nAn automated and a manual quality check was performed on the full time series.\r\nWe acknowledge Norsk Regnesentral (Norwegian Computing Center, NR) for downloading the MODIS data from NASA, and UNINETT Sigma2 AS (Sigma2, The Norwegian e-infrastructure for Research & Education) for providing the processing infrastructure for the CRDP generation from MODIS.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13661/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/30229/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206477/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206476/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206478/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206479/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206480/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206481/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206482/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206483/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206485/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206484/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206486/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215938/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206487/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206489/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215939/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215941/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/215942/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206488/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/45111/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2571/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_snow_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}