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

{
    "ob_id": 43442,
    "uuid": "c8fc3efdd6264b42ac84749b88219d95",
    "title": "Benthic images collected over different terrain features by Autonomous Underwater Vehicle during expedition JC257, 30 km south from the northern border of the UK-1 area of the Clarion-Clipperton Zone, Pacific Ocean, 2024",
    "abstract": "A collection of 2061 benthic still images was obtained using a downward-looking camera mounted on the UK Autosub5 Autonomous Underwater Vehicle (AUV), deployed from RRS James Cook during cruise JC257 in the abyssal plain (~4100 m depth) of the UK-1 exploration area of the Clarion-Clipperton Zone, Pacific Ocean, in 2024. During mission AS5M097, the AUV was programmed to replicate 21 parallel 1 km long transect lines in a site located 30 km South from the northern border of the UK-1 exploration area. The Grasshopper2 GS2-GE-50S5C camera mounted on the AUV collected vertically orientated still images at a target altitude of 3 m above the seabed, with one image being captured per second. Terrain features exhibiting different slope were delimited and images within each feature were randomly subsampled. These images were colour corrected to enhance visual fidelity and converted from original 8-bit RAW to JPG images. The final image set was inspected for overlap, which was non-existent. The image set was subsequently annotated using the online platform BIIGLE to derive ecological understanding on the influence of seabed topography on seabed community composition. 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": "2025-01-31T10:57:13",
    "doiPublishedTime": "2025-01-31T14:28:49",
    "updateFrequency": "notPlanned",
    "status": "final",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43441/?format=api",
        "dataPath": "/bodc/deposits01/soc240713",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 11321165883,
        "numberOfFiles": 2063,
        "fileFormat": "JPG"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12034/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4674/?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/13231/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206800/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206792/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206793/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206796/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206797/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206794/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206798/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/206799/?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": []
}