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

{
    "ob_id": 34720,
    "uuid": "906f6d3957f9439c98dfb662cda8a769",
    "title": "MSG: Dust imagery in the RGB channels over the full disc at 45.5 degrees East (LEDF41, from 1st June 2022)",
    "abstract": "The Meteosat Second Generation (MSG) satellites, operated by EUMETSAT (The European Organisation for the Exploitation of Meteorological Satellites), provide almost continuous imagery to meteorologists and researchers in Europe and around the world. These include visible, infra-red, water vapour, High Resolution Visible (HRV) images and derived cloud top height, cloud top temperature, fog, snow detection and volcanic ash products. These images are available for a range of geographical areas. \r\n\r\nThis dataset contains RGB dust images from MSG satellites over the full disc at 45.5 degrees East. Imagery available from 1000 UTC 1st June 2022 onwards at a frequency of 15 minutes (some are hourly) and are at least 24 hours old.\r\n\r\nNOTE - this dataset differs from the previous LEDF41 product produced using imagery from Meteosat-8 located at 41.5E. These new data are from Meteosat-9 which was drifted from previous operations over 3.5 E to 45.5 E between 1st February 2022 to 20th April 2022 to take over as the prime IODC (Indian Ocean Data Coverage) satellite by 1st June 2022.  See linked EUMETNET web page regarding this change in operation. The Met Office switched to providing this LEDF41 product from this new satellite at 0915 UTC on 1st June 2022, this dataset. See linked datasets for previous data. These are treated as two distinct datasets due to the shift in locational coverage.\r\n\r\nThe geographic extent for images within this datasets is available via the linked documentation 'MSG satellite imagery product geographic area details'. Each MSG imagery product area can be referenced from the third and fourth character of the image product name giving in the filename. E.g. for EEAO11 the corresponding geographic details can be found under the entry for area code 'AO' (i.e West Africa).",
    "keywords": "MSG, dust, rbd, Satellites, full disc",
    "publicationState": "published",
    "dataPublishedTime": "2022-06-06T10:23:52",
    "doiPublishedTime": null,
    "updateFrequency": "daily",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/34721/?format=api",
        "dataPath": "/badc/msg/data/hritimages/LEDF41_45E",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 72251661286,
        "numberOfFiles": 31380,
        "fileFormat": "Images are PNG formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9625/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2950/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data obtained by satellite from May 2022, prepared by the Met Office and stored in the CEDA Archive. This is a switch in the source satellite imagery for the LEDF41 product produced by the Met Office. See linked note regarding the switch in satellite providing the coverage for this region of the globe.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/11161/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/2645/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169044/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169041/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169038/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169040/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169042/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169045/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/14637/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2545/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "msg",
            "label": "restricted: msg group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/msg.pdf",
            "licenceClassifications": "academic"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}