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/43386/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 43386,
    "uuid": "80d96e3a14854420b6f742d70877c431",
    "title": "ESA Snow Climate Change Initiative (Snow_cci): Daily global Snow Cover Fraction - snow on ground (SCFG) from AVHRR (1979 - 2023), version 4.0",
    "abstract": "This dataset contains Daily Snow Cover Fraction (snow on ground) from AVHRR, produced by the Snow project of the ESA Climate Change Initiative programme. \r\n\r\nSnow cover fraction on ground (SCFG) indicates the area of snow observed from space over land surfaces, in forested areas corrected for the transmissivity of the forest canopy. The SCFG is given in percentage (%) per pixel. \r\n\r\nThe global SCFG product is available at about 5 km pixel size for all land areas, excluding Antarctica and Greenland ice sheets. The coastal zones of Greenland are included.\r\n\r\nThe SCFG time series provides daily products for the period 1979-2023.\r\n \r\nThe product V4.0 is based on EUMETSAT Fundamental Data Record (FDR) medium resolution optical satellite data from the Advanced Very High Resolution Radiometer (AVHRR). Clouds are masked using the CLARA-A3 cloud product. \r\n\r\nThe retrieval method of the snow_cci SCFG product from AVHRR data has been further developed and improved based on the ESA GlobSnow approach described by Metsämäki et al. (2015) and complemented with a pre-classification module. All cloud free pixels are then used for the snow extent mapping, using spectral bands centred at about 0.63 µm and 1.61 µm (channel 3a or the reflective part of channel 3b (ref3b)), and an emissive band centred at about 10.8 µm. The snow_cci snow cover mapping algorithm is a three-step approach: first, a strict pre-classification is applied to identify all cloud free pixels which are certainly snow free. For all remaining pixels, the snow_cci SCFG retrieval method is applied using dynamic reference reflectance values (snow, forest, ground) temporally and spatially adapted to consider angle dependencies (sun, view). Finally, a post-processing removes erroneous snow pixels caused either by falsely classified clouds in the tropics or by unreliable ref3b values at a global scale. \r\n\r\nThe following auxiliary data sets are used for product generation: i) ESA CCI Land Cover from 2000; water bodies and permanent snow and ice areas are masked based on this dataset. Both classes were separately aggregated to the pixel spacing of the SCF product. Water areas are masked if more than 50 percent of the pixel is classified as water, permanent snow and ice areas are masked if more than 50 percent are identified as such areas in the aggregated map; ii) Forest canopy transmissivity map; this layer is based on the tree cover classes of the ESA CCI Land Cover 2000 data set and the tree cover density map from Landsat data for the year 2000 (Hansen et al., Science, 2013, DOI: 10.1126/science.1244693). This layer is used to apply a forest canopy correction and estimate in forested areas the fractional snow cover on ground. RMSE is retrieved from a statistical model and added as pixel-wise information. \r\n\r\nThe SCFG product is aimed to serve the needs of users working in cryosphere and climate research and monitoring activities, including the detection of variability and trends, climate modelling and aspects of hydrology, meteorology, and biology.\r\n\r\nThe Remote Sensing Research Group of the University of Bern, in cooperation with Gamma Remote Sensing is responsible for the SCFG product development and generation. ENVEO (ENVironmental Earth Observation IT GmbH) developed and prepared all auxiliary data sets used for the product generation.\r\n\r\nThe SCFG AVHRR product comprises a few data gaps in 1979 – 1986 (1979: 22.-24.Feb.; 01.-07.Oct.; 03.-04.Nov.; 07.Nov.; 17.-18.Nov.; 1980: 22.-27.Feb.; 01.March; 03.March; 15.-20.March; 30.March – 02.April; 26.-29.June; 12.-19.July; 12.-18.Dec.; 1981: 09.-11.May; 01.-03.Aug.; 14.-23.Aug.; 1982: 28.- 31.May; 25.-26. Oct.; 1983: 27.- 31. July; 01.- 02. and 06. Aug.; 1984: 14.-15.Jan.; 06. Dec.; 1985: 01.- 24.Feb; 1986: 15. March), resulting in a 99% data coverage over the entire study period of 43 years.",
    "keywords": "ESA, CCI, Snow, Snow Cover Fraction",
    "publicationState": "citable",
    "dataPublishedTime": "2025-09-04T13:52:39",
    "doiPublishedTime": "2025-09-04T14:11:03",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44831/?format=api",
        "dataPath": "/neodc/esacci/snow/data/scfg/AVHRR_SINGLE/v4.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 569223567835,
        "numberOfFiles": 37064,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12643/?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/61132/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62644/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62645/?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 SCFG product based on AVHRR was developed and processed at the University of Bern in the frame of ESA CCI+ Snow project. The AVHRR baseline FCDR was pre-processed using pyGAC and pySTAT in the frame of the ESA CCI Cloud project (Devasthale et al. 2017). \r\nThe final product is quality checked.\r\n\r\nData were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13523/?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/206460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206462/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206463/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206464/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206465/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206467/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206468/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206469/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206470/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206471/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206472/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206473/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206474/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206475/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/44840/?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"
        }
    ]
}