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

{
    "ob_id": 40671,
    "uuid": "8801a4055e614e8d93e0418f6218eedf",
    "title": "Colour corrected seafloor BioCam images collected from the Darwin Mounds Marine Protected Area during RRS Discovery cruise DY108/109 (2019).",
    "abstract": "The dataset consists of georeferenced colour corrected images collected from the Darwin Mounds Marine Protected Area (MPA) during RRS Discovery cruise DY108/109 in 2019. Images were acquired using the BioCam seafloor imaging device of the University of Southampton mounted on the Autosub6000 Autonomous Underwater Vehicle (AUV) of the National Oceanography Centre. Two strobes, one mounted at the front and one at the back of the AUV, illuminated the seafloor when the colour camera of BioCam, mounted at the centre of the AUV, acquired those images once every 3 s. Images were stored in raw format along with timestamped navigation data (DVL, USBL, GPS). Data from different navigation sensors were fused with the images in post-processing using an extended Kalman smoother (EKS) implemented in oplab-pipeline (https://doi.org/10.5281/zenodo.6623369) The images were then colour corrected using an algorithm implemented in oplab-pipeline. The imaging survey was undertaken to demonstrate the BioCam technology developed by University of Southampton scientists under the NERC OCEANIDS programme's BioCam project (NE/P020887/1) to generate wide area 3D visual reconstructions of seafloor features.",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2023-09-01T14:58:59",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/40672/?format=api",
        "dataPath": "/bodc/SMI230145/BioCam_images_DY108-109/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 227326601346,
        "numberOfFiles": 20661,
        "fileFormat": "PNG"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11287/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3955/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "The data are archived on the British Oceanographic Data Centre (BODC)'s space at the Centre for Environmental Data Analysis (CEDA) and assigned a DOI. No quality control procedures were applied by BODC.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197911/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197910/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197908/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197907/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197906/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197928/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197929/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197909/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197930/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/197931/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}