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

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

{
    "ob_id": 37752,
    "uuid": "26b934d2731944dd945bc05406e40bee",
    "title": "MOYA:  In flight Methane samples, Llanos de Moxos, Bolivia 2019 with supporting GEOS-Chem and NAME model output",
    "abstract": "This dataset contains isotopic sampling of methane taken on board the British Antarctic Survey (BAS) twin-otter aircraft during a flight campaign over the Llanos de Moxos wetland near Trinidad, Bolivia in 2019 and supporting model simulations for the Methane Observations and Yearly Assessments (MOYA) project.  Air samples were collected in tedlar bags during flights over the region and subsequently analysed at the Greenhouse Gas Laboratory, Royal Holloway University (RHUL).  These are supported with data from a nested GEOS-Chem model simulation at 0.25° x 0.3125° which was used to map the relationship between emissions and aircraft measurements in a regional domain bounded by 24 - 0 °S and 75 – 55 °W. In addition, a footprint of the air source was simulated for each minute of aircraft sampling to capture using the Met Office NAME model at of 0.14° × 0.09° and temporal resolution of 3 hourly.",
    "keywords": "Methane, NAME, GEOS-Chem, aircraft",
    "publicationState": "published",
    "dataPublishedTime": "2022-07-26T14:29:41",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37753/?format=api",
        "dataPath": "/badc/moya/data/aircraft/Boliva_BAS-Flights_and_Model",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 372672338,
        "numberOfFiles": 9,
        "fileFormat": "Data are BADC-CSV and NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10429/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3559/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52193/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63572/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63573/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63574/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63575/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63577/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63578/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63581/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63585/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63594/?format=api"
    ],
    "dataLineage": "Data were collected locally and sent to RHUL for analysis and deposited at the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/24718/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180142/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180143/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180144/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180145/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180146/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180147/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180148/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180149/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180150/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180151/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180152/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180153/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180193/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/37757/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}