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

{
    "ob_id": 40760,
    "uuid": "b80870de014a43a498fc2684e78f32af",
    "title": "Retrieved sulfur dioxide column amounts and heights from the IASI instrument (9-30 April 2021) v1.0",
    "abstract": "This dataset contains retrievals of sulfur dioxide (SO2) from the Infrared Atmospheric Sounding Interferometer (IASI) on the MetOp platforms. This is a global dataset for 9-30th April 2021 which includes plumes from La Soufrière (St Vincent), Sabancaya (Peru) and Sangay (Ecuador). \r\n\r\nTwo retrieval schemes have been used: (1) Walker et al. (2011,2012) linear retrieval which flags pixels containing SO2 and (2) Carboni et al. (2012,2016) iterative retrieval which quantifies information about the SO2 including the column amount, height and the associated errors. The retrieved outputs are provided for individual IASI orbits. \r\n\r\nThis dataset was used to study the large plume of SO2 from the April 2021 eruption of La Soufrière on St Vincent in the Eastern Caribbean.  \r\n\r\nThe data has been produced by the Earth Observation Data Group at the University of Oxford, as part of the NERC Centre for the Observation and Modelling of Earthquakes, Volcanoes and Tectonics (COMET).",
    "keywords": "SO2,volcanic plumes,IASI,volcanic emissions,satellite observations",
    "publicationState": "citable",
    "dataPublishedTime": "2023-10-03T13:29:50",
    "doiPublishedTime": "2023-10-13T08:59:18.496525",
    "updateFrequency": "notPlanned",
    "status": "pending",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/40793/?format=api",
        "dataPath": "/neodc/iasi_so2_oxford/data/orbit-by-orbit/la_soufriere/v1.0/2021/04",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2189542230,
        "numberOfFiles": 937,
        "fileFormat": "netcdf"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11324/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3976/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75657/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75658/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75659/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75660/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75661/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75662/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75663/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75666/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75667/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75668/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75669/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75670/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75671/?format=api"
    ],
    "dataLineage": "The dataset has been produced by the Earth Observation Data Group at the University of Oxford, as part of the NERC Centre for the Observation and Modelling of Earthquakes, Volcanoes and Tectonics (COMET). The Oxford linear and iterative SO2 retrievals have been applied to the IASI level 1c files available at CEDA. The results were then passed to CEDA to be archived.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12721/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/11687/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198424/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198206/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198207/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198208/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198209/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198210/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198244/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198205/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198245/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/40761/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [],
    "discoveryKeywords": []
}