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

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

{
    "ob_id": 39092,
    "uuid": "0445629778dc4a5ea22a8c56f3ca5f99",
    "title": "PRIMAVERA: Met Office Hadley Centre (MOHC) HadGEM3-GC31-LM model output for the \"highresSST-future\" experiment",
    "abstract": "PRIMAVERA Project data from the Met Office Hadley Centre (MOHC) HadGEM3-GC31-LM model output for the \"forced atmosphere experiment for 2015-2050 using SST/sea-ice derived from CMIP5 RCP8.5 simulations and a scenario as close to RCP8.5 as possible within CMIP6\" (highresSST-future) experiment. These are available at the following frequencies: Prim1hr, Prim3hr, Prim3hrPt, Prim6hr, Prim6hrPt, Primday, PrimdayPt and PrimmonZ. The runs included the ensemble members: r1i14p1f1, r1i15p1f1, r1i1p1f1, r1i2p1f1 and r1i3p1f1.\n\nPRIMAVERA was a European Union Horizon2020 (grant agreement 641727) project.",
    "keywords": "PRIMAVERA, HighResMIP, climate change, MOHC, HadGEM3-GC31-LM, highresSST-future, Prim1hr, Prim3hr, Prim3hrPt, Prim6hr, Prim6hrPt, Primday, PrimdayPt, PrimmonZ",
    "publicationState": "published",
    "dataPublishedTime": "2022-11-14T20:23:45.898463",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39093/?format=api",
        "dataPath": "/badc/cmip6/data/PRIMAVERA/HighResMIP/MOHC/HadGEM3-GC31-LM/highresSST-future",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1218261767344,
        "numberOfFiles": 5509,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10831/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/9045/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13295/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50468/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50496/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50498/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50577/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52753/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52755/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/57952/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59392/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59393/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59395/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59396/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59398/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59399/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59400/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59401/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59402/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59404/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59406/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59410/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60427/?format=api"
    ],
    "dataLineage": "Data were produced and verified by Met Office Hadley Centre (MOHC) scientists before upload to the Centre for Environmental Data Analysis (CEDA) and publication via the Earth Systems Grid Federation (ESGF).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/39066/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/39094/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189547/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189549/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189550/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189546/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/189553/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/34187/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2520/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/CMIP6_Terms_of_Use.pdf",
            "licenceClassifications": ""
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}