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

{
    "ob_id": 43355,
    "uuid": "4bfed57aaa324847b5df139b7114e32c",
    "title": "Benthic images collected by Remotely Operated Vehicle during expedition JC241 in the UK-1 area of the Clarion-Clipperton Zone, Pacific Ocean, 2023",
    "abstract": "A collection of 7000 benthic still images was obtained using a downward-looking camera mounted on the UK ISIS Remotely Operated Vehicle (ROV), dive 413, deployed from RRS James Cook during cruise JC241 in the abyssal plain (~4100 m depth) of the northern part of the UK-1 exploration area of the Clarion-Clipperton Zone, Pacific Ocean, in 2023. The ROV was piloted to survey the seafloor across seven 2 km transect lines. The Grasshopper2 GS2-GE-50S5C camera system mounted on the ROV collected downward-looking still images at a target altitude of 3 m above the seabed. Images were colour corrected to enhance visual fidelity based on known sediment and nodule colours and converted from original 8-bit RAW to JPG images. Overlap among images was removed based on automated computer vision, and was later validated with human verification of overlap between successive images. The image set was subsequently annotated using the online platform BIIGLE (Bio-Image Indexing and Graphical Labelling Environment) to derive ecological understanding on seabed community composition under natural dynamics. The data were collected by scientists from the National Oceanography Centre, Southampton, UK as part of the NERC-funded Seabed Mining And Resilience To EXperimental impact (SMARTEX) project (NE/T003537/1).",
    "keywords": "",
    "publicationState": "citable",
    "dataPublishedTime": "2024-12-18T15:00:00",
    "doiPublishedTime": "2024-12-19T11:49:01",
    "updateFrequency": "notPlanned",
    "status": "final",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43353/?format=api",
        "dataPath": "/bodc/deposits01/soc240662",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 30799081980,
        "numberOfFiles": 7002,
        "fileFormat": "JPG"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11990/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4658/?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": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13217/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206349/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206346/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206347/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206348/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206350/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206351/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206352/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206354/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206355/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206356/?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": []
}