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

{
    "ob_id": 39899,
    "uuid": "af60720c1e404a9e9d2c145d2b2ead4e",
    "title": "ESA Biomass Climate Change Initiative (Biomass_cci): Global datasets of forest above-ground biomass for the years 2010, 2017, 2018, 2019 and 2020, v4",
    "abstract": "This dataset comprises estimates of forest above-ground biomass for the years 2010, 2017, 2018, 2019 and 2020. They are derived from a combination of Earth observation data, depending on the year, from the Copernicus Sentinel-1 mission, Envisat’s ASAR instrument and JAXA’s Advanced Land Observing Satellite (ALOS-1 and ALOS-2), along with additional information from Earth observation sources.    The data has been produced as part of the European Space Agency's (ESA's) Climate Change Initiative (CCI) programme by the Biomass CCI team.  \r\n\r\nThis release of the data is version 4.  Compared to version 3, version 4 consists of an update of the three maps of AGB for the years 2010, 2017 and 2018 and new AGB maps for 2019 and 2020. New AGB change maps have been created for consecutive years (2018-2017, 2019-2018 and 2020-2019) and for a decadal interval (2020-2010). The pool of remote sensing data now includes multi-temporal observations at L-band for all biomes and for all years. The AGB maps rely on revised allometries which are now based on a longer record of spaceborne LiDAR data from the GEDI and ICESat-2 missions. Temporal information is now implemented in the retrieval algorithm to preserve biomass dynamics as expressed in the remote sensing data. Biases between 2010 and more recent years have been reduced.\r\n\r\n\r\n\r\nThe data products consist of two (2) global layers that include estimates of:\r\n1) above ground biomass (AGB, unit: tons/ha i.e., Mg/ha)  (raster dataset).   This is defined as the mass, expressed as oven-dry weight of the woody parts (stem, bark, branches and twigs) of all living trees excluding stump and roots\r\n2) per-pixel estimates of above-ground biomass uncertainty expressed as the standard deviation in Mg/ha (raster dataset)\r\n\r\nIn addition, files describing the AGB change between two consecutive years (i.e., 2018-2017, 2019-2018 and 2020-2010) and over a decade (2020-2010) are provided (labelled as 2018_2017, 2019_2018, 2020_2019 and 2020_2010). Each AGB change product consists of two sets of maps: the standard deviation of the AGB change and a quality flag of the AGB change. Note that the change itself can be simply computed as the difference between two AGB maps, so is not provided directly.\r\n\r\n\r\nData are provided in both netcdf and geotiff format.",
    "keywords": "ESA, CCI, Biomass",
    "publicationState": "citable",
    "dataPublishedTime": "2023-04-21T13:38:53",
    "doiPublishedTime": "2023-04-21T14:21:43",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39940/?format=api",
        "dataPath": "/neodc/esacci/biomass/data/agb/maps/v4.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 302039423059,
        "numberOfFiles": 5182,
        "fileFormat": "Data are netCDF and geotiff formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8795/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?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/6023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66280/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66281/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66282/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66283/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66287/?format=api"
    ],
    "dataLineage": "Data was created by the Biomass CCI team.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12470/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/29954/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194230/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194231/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194232/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194233/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194234/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194235/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194236/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194237/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194238/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/194239/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/33268/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2542/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_biomass_terms_and_conditions_v2.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}