GET

Observation Instance

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

{
    "ob_id": 39814,
    "uuid": "5f7206e5854246a9ae7498305d620590",
    "title": "UM-UKCA model data for study investigating the QBO response to large tropical eruptions",
    "abstract": "This dataset contains summary 36-month data of the global mean volcanic stratospheric aerosol optical depth, temperature, sulfate aerosol mass concentration and wind velocities necessary for analysing the quasi-biennial oscillation (QBO). The data are from 8 model simulations of volcanic eruptions that have different sulfur dioxide emissions, eruption initiation date/season and QBO phase at the time of eruption. Three control ensembles were conducted for each initial condition. The simulations are from the Unified Model coupled with the United Kingdom Chemistry and Aerosol Scheme (UM-UKCA) Vn.11.2 and were conducted at a global resolution of 1.875 ° x 1.25°.\r\n\r\nVariables for calculating the QBO momentum budget (w*, flux divergence) are contained in the files ending ‘_momentum.nc’.\r\n\r\nThere are files for each initial condition named '{SEASON}_{SO2_INJECTION_MAGNITUDE}_{QBO_PHASE}.nc'.\r\n\r\nThere are 12 control files to give three ensemble members for each initial condition. These files are named ‘{SEASON}_{QBO_PHASE}_control_{no.}.nc’ for example: ‘July_wQBO_control_2.nc’.",
    "keywords": "UM-UKCA, QBO, quasi-biennial oscillation, tropical eruptions, volcanic",
    "publicationState": "citable",
    "dataPublishedTime": "2023-04-05T13:04:12",
    "doiPublishedTime": "2023-04-06T08:24:41",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39815/?format=api",
        "dataPath": "/badc/deposited2023/UKCA_volcanic_eruptions_QBO",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 40538150779,
        "numberOfFiles": 30,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11014/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18924/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19038/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22005/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55648/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55978/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62528/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62529/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62530/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62531/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62532/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62533/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62534/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62535/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62536/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62537/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62538/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62539/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62540/?format=api"
    ],
    "dataLineage": "Data were generated using the Met Office Unified Model coupled with the United Kingdom Chemistry and Aerosol Scheme (UM-UKCA) Vn.11.2.\r\nData was converted to netCDF",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12457/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/39817/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193923/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193924/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193925/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193926/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193928/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193921/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193922/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193932/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193929/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193930/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/193931/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/39816/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2521/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": []
}