Observation Instance – Django REST framework

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/43174/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 43174,
    "uuid": "1f4ebb2944ec43a39ce6c69a8f1942fb",
    "title": "HadCM3 simulation data and model inputs supporting the manuscript \"Simulated millennial-scale climate variability driven by a convection-advection oscillator\"",
    "abstract": "This record contains Hadley Centre Coupled Model, version 3 (HadCM3) simulation data produced for the manuscript \"Simulated millennial-scale climate variability driven by a convection-advection oscillator\" by Y.M. Rome et al, submitted to Climate Dynamics https://doi.org/10.1007/s00382-025-07630-x\r\n\r\nThis paper introduces the convection-advection oscillator mechanism to explain the millennial-scale oscillations observed in a set of HadCM3 general circulation model simulations forced with snapshots of deglacial meltwater history. The oscillating simulation was compared to different simulations using a different meltwater forcing and model parametrisation to extract the main components at stake in the establishment of the oscillations. This record also includes a rerun of the primary oscillating simulation with additional salinity tendencies diagnostic included.\r\n\r\nThis results in six HadCM3 simulations of the Last Glacial Maximum (21,000 years ago) integrated over 3,000 to 10,000 years. The model outputs were saved as netcdf files, and the data were cropped to only include the fields relevant to the figures of the paper. This dataset can be used as the input of the companion scripts accessible using the following DOI: 10.5281/zenodo.13710877. The dataset also includes some of the model inputs, namely the land-sea mask, basin files, meltwater forcing and waterfix, necessary for the reproducibility of the results.",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2025-08-19T15:45:56",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43550/?format=api",
        "dataPath": "/badc/deposited2024/lgm_oscillations_convadv/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 9051796032,
        "numberOfFiles": 116,
        "fileFormat": "NetCDF and CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11871/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4584/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1322/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3053/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3063/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3699/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/7565/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/16668/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74532/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75001/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75003/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75004/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75005/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75006/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75007/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75008/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75009/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75010/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75011/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75025/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75026/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75027/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75030/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75031/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75032/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75033/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75034/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75035/?format=api"
    ],
    "dataLineage": "The main simulations were run for Romé et al. 2022 ( https://doi.org/10.1029/2022PA004451) and adapted for the specificity of the manuscript corresponding to this paper. This dataset also includes a rerun of the previous experiments with additional salinity tendencies outputs (XOUPK) and a sensitivity experiment without the global salinity scripts (XPPBF). The data here have been extracted from the raw outputs of HadCM3.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/38094/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/207957/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205288/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205283/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205290/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205291/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205292/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/26560/?format=api",
    "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": []
}